Функция SQLCleanupConnectionPoolID

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

Сводка
SQLCleanupConnectionPoolID сообщает драйверу, что идентификатор пула был истечён. Идентификатор пула может заканчиваться, когда все соединения в пуле, связанном с этим ID, были истечены по времени. См. раздел «Пулирование в компонентах доступа к данным Microsoft» для получения дополнительной информации о тайм-ауте соединения.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Arguments

EnvironmentHandle
[Ввод] Окружающая ручка пула.

PoolID
[Ввод] Пул, связанный с идентификатором пула, который был истечён.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR или SQL_INVALID_HANDLE.

Diagnostics

Менеджер драйверов не обрабатывает диагностическую информацию, возвращаемую из SQLCleanupConnectionPoolID.

Приложение не может получить сообщение об ошибке, возвращаемое драйвером.

Remarks

SQLCleanupConnectionPoolID можно вызвать в любое время, но менеджер драйверов гарантирует, что ни один другой поток одновременно не вызывает SQLGetPoolID , и ни один другой поток не вызывает одновременно SQLRateConnection и SQLPoolConnect с токеном информации соединения, назначенным с этим идентификатором пула. Поэтому драйвер должен убедиться, что эта функция безопасна по потоку.

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

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

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

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

  • Last updated on