Функция SQLSetConnectInfo

Соответствия
Представлена версия: соответствие стандартам ODBC 3.81: ODBC

Сводка
SQLSetConnectInfo используется для задания источника данных, идентификатора пользователя и пароля в маркер сведений о подключении для вызова SQLConnect приложения.

Синтаксис

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );  

Аргументы

TokenHandle
[Входные данные] Дескриптор маркера.

ServerName
[Входные данные] Имя источника данных. Данные могут находиться на том же компьютере, что и программа, или на другом компьютере в сети. Сведения о том, как приложение выбирает источник данных, см. в разделе "Выбор источника данных" или "Драйвер".

NameLength1
[Входные данные] Длина *ServerName в символах.

UserName
[Входные данные] Идентификатор пользователя.

NameLength2
[Входные данные] Длина *UserName в символах.

Проверка подлинности
[Входные данные] Строка проверки подлинности (обычно пароль).

NameLength3
[Входные данные] Длина *Аутентификации в символах.

Возвраты

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR или SQL_INVALID_HANDLE.

Диагностика

Аналогично SQLConnect для ошибок проверки входных данных, за исключением того, что диспетчер драйверов будет использовать HandleType SQL_HANDLE_DBC_INFO_TOKEN и дескриптор hDbcInfoToken.

Замечания

Когда драйвер возвращает SQL_ERROR или SQL_INVALID_HANDLE, диспетчер драйверов возвращает ошибку приложению (в SQLConnect или SQLDriverConnect).

Когда драйвер возвращает SQL_SUCCESS_WITH_INFO, диспетчер драйверов получит диагностические сведения из hDbcInfoToken и возвращает SQL_SUCCESS_WITH_INFO приложению в SQLConnect и SQLDriverConnect.

Приложения не должны вызывать эту функцию напрямую. Драйвер ODBC, поддерживающий пул подключений с поддержкой драйверов, должен реализовать эту функцию.

Включите sqlspi.h для разработки драйверов ODBC.

См. также

Разработка драйвера ODBC
Организация пулов соединений с учетом драйвера
Разработка драйвера ODBC с поддержкой пула подключений