Функция SQLSetDriverConnectInfo

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

Сводка
SQLSetDriverConnectInfo используется для установки строка подключения в токен информации о соединении для вызова SQLDriverConnect приложения.

Syntax

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );

Arguments

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

InConnectionString
[Ввод] Full строка подключения (см. синтаксис в разделе «Comments» в SQLDriverConnect), частичная строка подключения или пустая строка.

StringLength1
[Ввод] Длина *InConnectionString, в символах, если строка Unicode, или в байтах, если строка ANSI или DBCS.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR или SQL_INVALID_HANDLE.

Diagnostics

То же самое, что и в SQLDriverConnect , связанное с любой ошибкой проверки входных данных, за исключением того, что менеджер драйверов использует 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