ЛИНТЕР

SQLDriverConnect

Назначение

Загружает драйвер и устанавливает соединение с источником данных, используя дополнительную информацию, при необходимости высвечивает диалоговое окно для ввода дополнительных параметров соединения.

Поддерживает передачу параметров соединения через:

строку соединения, содержащую наименование источника данных, один или несколько идентификаторов пользователей, один или несколько паролей и другую информацию, требуемую источником данных;
диалоговое окно для приема от пользователя информации (рис. 6).

Рисунок 6. Окно ввода параметров соединения

Особенности

Значения аргументов функции SQLDriverConnect представлены в таблице 5.

Таблица 5. Аргументы функции SQLDriverConnect

Аргумент Допустимые значения

Аргумент	Допустимые значения
SzConnStrIn	Строка формата DSN=<dsn>;UID=<uid>;{PWD\|PASSWORD}=<pwd>; SERVER=<server>;TXN=<txn>; WCHARDEFAULT=<wchardefault>; BUFFERED_FETCH=<buffered_fetch>; TRUSTED_CONNECTION=<trusted_connection> где: `dsn`: наименование источника данных; `uid`: имя пользователя; `pwd`: пароль пользователя; `server`: удаленный ЛИНТЕР-сервер; `txn`: режим обработки транзакций. Допустимые значения: OPTIMISTIC, PESSIMISTIC, AUTOCOMMIT; Примечание Режим OPTIMISTIC устарел. Применять не рекомендуется. `wchardefault`: тип символьных данных `SQL_C_DEFAULT`: `SQL_C_WCHAR` или `SQL_C_CHAR`; `buffered_fetch`: управляет режимом оптимизации буферизированного чтения. Даже когда пользователь не задаёт массив ответов, данные будут выбираться всё равно пакетами: TRUE – режим включен, FALSE – отключен. По умолчанию режим отключен; `trusted_connection`: дает возможность осуществить подключение к БД без указания учетных данных пользователя (имени/пароля). В качестве примера может служить подключение через протокол `Kerberos` (см. документ «Архитектура СУБД» («Авторизация пользователей»)). Допустимые значения: TRUE, FALSE, YES, NO.

SzConnStrIn

Строка формата

DSN=<dsn>;UID=<uid>;{PWD|PASSWORD}=<pwd>;
SERVER=<server>;TXN=<txn>;
WCHARDEFAULT=<wchardefault>;
BUFFERED_FETCH=<buffered_fetch>;
TRUSTED_CONNECTION=<trusted_connection>

где:

dsn: наименование источника данных;
uid: имя пользователя;
pwd: пароль пользователя;
server: удаленный ЛИНТЕР-сервер;
txn: режим обработки транзакций. Допустимые значения: OPTIMISTIC, PESSIMISTIC, AUTOCOMMIT;

Примечание

Режим OPTIMISTIC устарел. Применять не рекомендуется.
wchardefault: тип символьных данных SQL_C_DEFAULT: SQL_C_WCHAR или SQL_C_CHAR;
buffered_fetch: управляет режимом оптимизации буферизированного чтения. Даже когда пользователь не задаёт массив ответов, данные будут выбираться всё равно пакетами: TRUE – режим включен, FALSE – отключен. По умолчанию режим отключен;
trusted_connection: дает возможность осуществить подключение к БД без указания учетных данных пользователя (имени/пароля). В качестве примера может служить подключение через протокол Kerberos (см. документ «Архитектура СУБД» («Авторизация пользователей»)). Допустимые значения: TRUE, FALSE, YES, NO.

Примечание

Режим BUFFERED_FETCH значительно увеличивает скорость массовой последовательной выборки данных, но не действует на выборку, в которой присутствует хотя бы один BLOB-столбец.