Функция SQLSetConnectInfo

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

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

Syntax

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

Arguments

TokenHandle
[Ввод] Токен-аккаунт.

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

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

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

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

Authentication
[Ввод] Строка аутентификации (обычно пароль).

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

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR или SQL_INVALID_HANDLE.

Diagnostics

То же самое с SQLConnect для ошибок проверки ввода, за исключением того, что Driver Manager использует HandleType SQL_HANDLE_DBC_INFO_TOKEN и HandlehDbcInfoToken.

Remarks

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

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

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

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

Связанные материалы

  • Last updated on