SQLCleanupConnectionPoolID 函式

符合性
推出版本:ODBC 3.81 標準合規:ODBC

總結
SQLCleanupConnectionPoolID 會通知驅動程式某池 ID 已逾時。當池中所有與該池 ID 相關的連線都超時時,池 ID 可能會逾時。有關連線逾時的更多資訊,請參閱 Microsoft 資料存取元件中的池化。

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );  

論點

環境控制
[輸入]泳池的環境把手。

PoolID
[輸入]那個與池 ID 綁定且已逾時的池池。

Returns

SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR或SQL_INVALID_HANDLE。

Diagnostics

驅動程式管理器不會處理從 SQLCleanupConnectionPoolID 回傳的診斷資訊。

應用程式無法接收驅動程式回傳的錯誤訊息。

備註

SQLCleanupConnectionPoolID 可以隨時被呼叫,但驅動程式管理器會保證沒有其他執行緒同時呼叫 SQLGetPoolID ,也沒有其他執行緒同時呼叫 SQLRateConnectionSQLPoolConnect ,且該連線資訊標記與該池 ID 相符。 因此,驅動程式必須確保此函式是執行緒安全的。

司機可以清理與池 ID 相關的資源。

應用程式不應直接呼叫此函式。 支援驅動程式感知連線池的 ODBC 驅動程式必須實作此功能。

請包含 sqlspi.h 以開發 ODBC 驅動程式。