符合性
推出版本: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 ,也沒有其他執行緒同時呼叫 SQLRateConnection 和 SQLPoolConnect ,且該連線資訊標記與該池 ID 相符。 因此,驅動程式必須確保此函式是執行緒安全的。
司機可以清理與池 ID 相關的資源。
應用程式不應直接呼叫此函式。 支援驅動程式感知連線池的 ODBC 驅動程式必須實作此功能。
請包含 sqlspi.h 以開發 ODBC 驅動程式。