Функция SQLCleanupConnectionPoolID

Статья
08/21/2023

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

Сводка
SQLCleanupConnectionPoolID сообщает драйверу о истечении времени ожидания идентификатора пула. Идентификатор пула может истекает, когда все подключения в пуле, связанном с этим идентификатором пула, истекли. Дополнительные сведения о времени ожидания подключения см . в разделе "Пул" в компонентах доступа к данным Майкрософт.

Синтаксис

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Аргументы

EnvironmentHandle
[Входные данные] Дескриптор среды пула.

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

Возвраты

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR или SQL_INVALID_HANDLE.

Диагностика

Диспетчер драйверов не обрабатывает диагностические сведения, возвращаемые из SQLCleanupConnectionPoolID.

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

Замечания

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

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

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

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

См. также

Разработка драйвера ODBC
Организация пулов соединений с учетом драйвера
Разработка драйвера ODBC с поддержкой пула подключений

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