Функция SQLSetDriverConnectInfo

Статья
08/21/2023

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

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

Синтаксис

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

Аргументы

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

InConnectionString
[Входные данные] Полная строка подключения (см. синтаксис в комментариях в SQLDriverConnect), строка частичного подключения или пустая строка.

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

Возвраты

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR или SQL_INVALID_HANDLE.

Диагностика

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

Поделиться через