| description | SQLCleanupConnectionPoolID Function | |
|---|---|---|
| title | SQLCleanupConnectionPoolID Function | Microsoft Docs | |
| ms.custom | ||
| ms.date | 01/19/2017 | |
| ms.prod | sql | |
| ms.prod_service | connectivity | |
| ms.reviewer | ||
| ms.technology | connectivity | |
| ms.topic | reference | |
| helpviewer_keywords |
|
|
| ms.assetid | 1fc61908-e003-4587-b91a-32f40569fb99 | |
| author | David-Engel | |
| ms.author | v-davidengel |
Conformance
Version Introduced: ODBC 3.81 Standards Compliance: ODBC
Summary
SQLCleanupConnectionPoolID informs a driver that a pool ID was timed out. A pool ID can timeout whenever all connections in a pool associated with that pool ID were timed out. See Pooling in the Microsoft Data Access Components for more information about connection timeout.
SQLRETURN SQLCleanupConnectionPoolID (
SQLHENV EnvironmentHandle
SQLPOOLID PoolID ); EnvironmentHandle
[Input] The environment handle of the pool.
PoolID
[Input] The pool associated to the pool ID that was timed out.
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, or SQL_INVALID_HANDLE.
The Driver Manager will not process diagnostic information returned from SQLCleanupConnectionPoolID.
An application cannot receive the error message returned by the driver.
SQLCleanupConnectionPoolID can be called at any time, but the Driver Manager guarantees that no other thread is simultaneously calling SQLGetPoolID and no other thread is simultaneously calling SQLRateConnection and SQLPoolConnect with a connection info token assigned with that pool ID. Therefore, the driver must make sure this function is thread safe.
A driver can clean up the resources associated with the pool ID.
Applications should not call this function directly. An ODBC driver that supports driver-aware connection pooling must implement this function.
Include sqlspi.h for ODBC driver development.
Developing an ODBC Driver
Driver-Aware Connection Pooling
Developing Connection-Pool Awareness in an ODBC Driver