Функция SQLGetPoolID

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

Сводка
SQLGetPoolID получает идентификатор пула.

Syntax

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Arguments

hDbcInfoToken
[Ввод] Токен-дескриптор, содержащий всю информацию о соединении.

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

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR или SQL_INVALID_HANDLE.

Diagnostics

Когда SQLGetPoolID возвращает SQL_ERROR или SQL_SUCCESS_WITH_INFO, менеджер драйверов использует HandleType SQL_HANDLE_DBC_INFO_TOKEN и HandlehDbcInfoToken.

Remarks

SQLGetPoolID используется для получения идентификатора пула с набором информации о соединениях (от SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo и SQLSetConnectInfo). Этот идентификатор пула используется для идентификации набора соединений, которые могут использоваться взаимозаменяемо (возможно, потребуется дополнительный сброс). ID пула будет использоваться для идентификации пула соединений для этой группы соединений.

Всякий раз, когда драйвер возвращает 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