SQLCleanupConnectionPoolID-funktion

Överensstämmelse
Version introducerad: ODBC 3.81 Standardefterlevnad: ODBC

Summary
SQLCleanupConnectionPoolID informerar en drivrutin om att ett pool-ID var tidsavgränsat. Ett pool-ID kan gå ut när alla anslutningar i en pool kopplad till det pool-ID:t har tidsavgränsats. Se Pooling i Microsoft Data Access Components för mer information om anslutningstidsavbrott.

Syntax

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );  

Arguments

EnvironmentHandle
[Input] Miljöhandtaget för poolen.

PoolID
[Input] Poolen kopplad till pool-ID:t som var tidsutsatt.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR eller SQL_INVALID_HANDLE.

Diagnostics

Driver Manager kommer inte att bearbeta diagnostisk information som returneras från SQLCleanupConnectionPoolID.

En applikation kan inte ta emot felmeddelandet som drivrutinen returnerar.

Remarks

SQLCleanupConnectionPoolID kan anropas när som helst, men Driver Manager garanterar att ingen annan tråd samtidigt anropar SQLGetPoolID och ingen annan tråd samtidigt anropar SQLRateConnection och SQLPoolConnect med en anslutningsinfotoken tilldelad det pool-ID:t. Därför måste föraren se till att denna funktion är trådsäker.

En drivrutin kan rensa upp resurserna kopplade till pool-ID:t.

Applikationer bör inte anropa denna funktion direkt. En ODBC-drivrutin som stödjer drivrutinsmedveten anslutningspooling måste implementera denna funktion.

Inkludera sqlspi.h för ODBC-drivrutinsutveckling.