SQLCleanupConnectionPoolID 函式
一致性
引進的版本：ODBC 3.81 標準合規性：ODBC
摘要
SQLCleanupConnectionPoolID 會通知驅動程式集區識別碼已逾時。每當與該集區識別碼相關聯的集區中的所有連線逾時時，集區識別碼就會逾時。如需連線逾時的詳細資訊，請參閱 Microsoft 資料存取元件 中的共用。
語法
SQLRETURN SQLCleanupConnectionPoolID (
SQLHENV EnvironmentHandle
SQLPOOLID PoolID );
引數
EnvironmentHandle
[輸入]集區的環境控制碼。
PoolID
[輸入]與已逾時之集區識別碼相關聯的集區。
傳回
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR或SQL_INVALID_HANDLE。
診斷
驅動程式管理員不會處理從 SQLCleanupConnectionPoolID 傳回的診斷資訊。
應用程式無法接收驅動程式傳回的錯誤訊息。
備註
您可以隨時呼叫 SQLCleanupConnectionPoolID，但 Driver Manager 會保證沒有其他執行緒同時呼叫 SQLGetPoolID ，而且沒有其他執行緒同時呼叫 SQLRateConnection 和 SQLPoolConnect ，且該集區識別碼指派的連接資訊權杖。 因此，驅動程式必須確定此函式是安全線程。
驅動程式可以清除與集區識別碼相關聯的資源。
應用程式不應該直接呼叫此函式。 支援驅動程式感知連接共用的 ODBC 驅動程式必須實作此函式。
包含 sqlspi.h 以進行 ODBC 驅動程式開發。