Функция SQLPoolConnect

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

Сводка
SQLPoolConnect используется для создания нового соединения, если соединение в пуле не может быть повторно использовано.

Syntax

  
SQLRETURN  SQLPoolConnect(  
                SQLHDBC              hDbc,  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              wszOutConnectString,  
                SQLSMALLINT          cchConnectStringBuffer,  
                SQLSMALLINT *        cchConnectStringLen );

Arguments

hDbc
[Ввод] Ручка подключения.

hDbcInfoToken
[Ввод] Токен для запроса соединения нового приложения.

wszOutConnectString
[Выход] Указатель на буфер для завершённой строка подключения. После успешного подключения к целевому источнику данных этот буфер содержит завершённую строка подключения. Приложения должны выделить не менее 1 024 символа для этого буфера.

Если wszOutConnectString равно NULL, cchConnectStringLen всё равно вернёт общее количество символов (за исключением символа null-termination для данных символов), доступных для возврата в буфере, на который указывает wszOutConnectString.

cchConnectStringBuffer
[Ввод] Длина буфера *wszOutConnectString , в символах.

cchConnectStringLen
[Выход] Указатель на буфер для возврата общего количества символов (без учёта символа null-termination), доступных для возврата в *wszOutConnectString. Если количество доступных для возврата символов больше или равно cchConnectStringBuffer, завершённая строка подключения в *wszOutConnectStringString усекается до cchConnectStringBuffer минус длина символа null-termination.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, или SQL_INVALID_HANDLE.

Diagnostics

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

Remarks

Driver Manager гарантирует, что материнский HENV-дескриптор hDbc и hDbcInfoToken совпадают.

В отличие от SQLDriverConnect, здесь нет аргумента DriverCompletion , который бы попросил пользователей ввести информацию о соединении. Диалог с подсказками в сценарии пула запрещён.

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

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

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

Когда приложение использует SQLConnect, wszOutConnectString будет буфером NULL (последние три параметра будут установлены как NULL, 0, NULL). В противном случае драйвер должен вернуть выходную строка подключения, которая будет возвращена в вызов функции SQLDriverConnect приложения.

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

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

  • Last updated on