SQLCleanupConnectionPoolID 函数

一致性
推出版本: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 驱动。