一致性
推出版本:ODBC 3.81 标准合规:ODBC
总结
SQLCleanupConnectionPoolID 会通知驱动程序某个池 ID 超时。当池 ID 关联的所有连接都超时时,池 ID 可能会超时。有关连接超时的更多信息,请参见 Microsoft 数据访问组件中的池化。
Syntax
SQLRETURN SQLCleanupConnectionPoolID (
SQLHENV EnvironmentHandle
SQLPOOLID PoolID );
Arguments
环境控制
[输入]泳池的环境把手。
池ID
[输入]与被超时的池ID关联的池。
Returns
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR 或SQL_INVALID_HANDLE。
诊断
驱动程序管理器不会处理来自 SQLCleanupConnectionPoolID 返回的诊断信息。
应用程序无法接收驱动程序返回的错误信息。
Remarks
SQLCleanupConnectionPoolID 可以随时调用,但驱动程序管理器保证没有其他线程同时调用 SQLGetPoolID ,也没有其他线程同时调用 SQLRateConnection 和 SQLPoolConnect ,且该组 ID 分配了连接信息令牌。 因此,驱动程序必须确保该功能是线程安全的。
驱动程序可以清理与池ID相关的资源。
应用程序不应直接调用该函数。 支持驱动程序识别连接池的 ODBC 驱动程序必须实现此功能。
包含 sqlspi.h 以开发 ODBC 驱动。