Functie SQLCleanupConnectionPoolID

Conformiteit
Versie geïntroduceerd: ODBC 3.81 Standaardnaleving: ODBC

Samenvatting
SQLCleanupConnectionPoolID informeert een driver dat een pool-ID is getimed. Een pool-ID kan time-out wanneer alle verbindingen in een pool die aan die pool-ID gekoppeld zijn, zijn getimed. Zie Pooling in de Microsoft Data Access Components voor meer informatie over verbindingstimeout.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Arguments

EnvironmentHandle
[Invoer] De omgevingshandle van het zwembad.

PoolID
[Invoer] Het zwembad gekoppeld aan de pool-ID die was getimed.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR of SQL_INVALID_HANDLE.

Diagnostiek

De Driver Manager verwerkt geen diagnostische informatie die wordt teruggegeven door SQLCleanupConnectionPoolID.

Een applicatie kan het foutbericht dat door de driver wordt teruggegeven niet ontvangen.

Remarks

SQLCleanupConnectionPoolID kan op elk moment worden aangeroepen, maar de Driver Manager garandeert dat geen enkele andere thread tegelijkertijd SQLGetPoolID aanroept en geen enkele andere thread tegelijkertijd SQLRateConnection en SQLPoolConnect aanroept met een verbindingsinformatietoken dat met die pool-ID is toegewezen. Daarom moet de driver ervoor zorgen dat deze functie thread-veilig is.

Een driver kan de resources die aan de pool-ID zijn gekoppeld opruimen.

Applicaties mogen deze functie niet direct aanroepen. Een ODBC-driver die driver-bewuste verbindingspooling ondersteunt, moet deze functie implementeren.

Voeg sqlspi.h toe voor ODBC-driverontwikkeling.

Verwante onderwerpen

  • Last updated on