SQLCleanupConnectionPoolID-Funktion

Konformität
Version eingeführt: ODBC 3.81 Standards Compliance: ODBC

Zusammenfassung
SQLCleanupConnectionPoolID informiert einen Treiber darüber, dass für eine Pool-ID ein Timeout aufgetreten ist. Für eine Pool-ID kann ein Timeout auftreten, wenn für alle Verbindungen in einem Pool, der dieser Pool-ID zugeordnet ist, ein Timeout auftritt. Weitere Informationen zum Verbindungstimeout finden Sie unter Pooling in den Microsoft Data Access-Komponenten .

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );  

Argumente

EnvironmentHandle
[Eingabe] Das Umgebungshandle des Pools.

PoolID
[Eingabe] Der Pool, der der Pool-ID zugeordnet ist, für die ein Timeout aufgetreten ist.

Gibt zurück

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR oder SQL_INVALID_HANDLE.

Diagnose

Der Treiber-Manager verarbeitet keine von SQLCleanupConnectionPoolID zurückgegebenen Diagnoseinformationen.

Eine Anwendung kann die vom Treiber zurückgegebene Fehlermeldung nicht empfangen.

Bemerkungen

SQLCleanupConnectionPoolID kann jederzeit aufgerufen werden, aber der Treiber-Manager garantiert, dass kein anderer Thread gleichzeitig SQLGetPoolID aufruft, und kein anderer Thread gleichzeitig SQLRateConnection und SQLPoolConnect mit einem Verbindungsinformationstoken aufruft, das dieser Pool-ID zugewiesen ist. Daher muss der Treiber sicherstellen, dass diese Funktion threadsicher ist.

Ein Treiber kann die Ressourcen bereinigen, die der Pool-ID zugeordnet sind.

Anwendungen sollten diese Funktion nicht direkt aufrufen. Diese Funktion muss von einem ODBC-Treiber implementiert werden, der treiberbasierte Verbindungspools unterstützt.

Schließen Sie sqlspi.h für die ODBC-Treiberentwicklung ein.

Weitere Informationen

Entwickeln eines ODBC-Treibers
Treiberfähiges Verbindungspooling
Entwickeln von Verbindungspool-Unterstützung in einem ODBC-Treiber