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 驅動程式開發。

另請參閱

開發 ODBC 驅動程式
可感知驅動程式的連接共用
在 ODBC 驅動程式中開發連線集區覺察