SQLCleanupConnectionPoolID-Funktion

Konformität
Eingeführte Version: ODBC 3.81 Normeneinhaltung: ODBC

Summary
SQLCleanupConnectionPoolID informiert einen Treiber darüber, dass eine Pool-ID zeitüberlaufen wurde. Eine Pool-ID kann dann timeouten, wenn alle Verbindungen in einem Pool, der mit dieser Pool-ID verknüpft ist, abgelaufen sind. Weitere Informationen zum Verbindungszeitpunkt finden Sie unter Pooling in den Microsoft Data Access Components.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );  

Argumente

EnvironmentHandle
[Eingabe] Der Umwelthandle des Pools.

PoolID
[Eingabe] Der Pool, der mit der Pool-ID verknüpft war, wurde zeitlich abgestimmt.

Rücklieferungen

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR oder SQL_INVALID_HANDLE.

Diagnostics

Der Driver Manager verarbeitet keine Diagnoseinformationen, die von SQLCleanupConnectionPoolID zurückgegeben werden.

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

Bemerkungen

SQLCleanupConnectionPoolID kann jederzeit aufgerufen werden, aber der Driver Manager garantiert, dass kein anderer Thread gleichzeitig SQLGetPoolID aufruft und kein anderer Thread gleichzeitig SQLRateConnection und SQLPoolConnect mit einem Connection Info-Token mit diesem Pool-ID aufruft. Daher muss der Treiber sicherstellen, dass diese Funktion threadsicher ist.

Ein Treiber kann die mit der Pool-ID verknüpften Ressourcen bereinigen.

Anwendungen sollten diese Funktion nicht direkt aufrufen. Ein ODBC-Treiber, der treiberbewusstes Connection Pooling unterstützt, muss diese Funktion implementieren.

Fügen Sie sqlspi.h für die Entwicklung von ODBC-Treibern hinzu.