Funzione SQLCleanupConnectionPoolID

Conformità
Versione introdotta: Conformità agli standard ODBC 3.81: ODBC

Sommario
SQLCleanupConnectionPoolID informa un driver che un ID pool è stato timeout. Un ID pool può scadere ogni volta che tutte le connessioni in un pool associate a quell'ID pool sono state timeout. Vedi Pooling nei Componenti di Accesso Dati Microsoft per maggiori informazioni sul timeout della connessione.

Sintassi

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Arguments

EnvironmentHandle
[Input] L'ambiente della piscina.

PoolID
[Input] Il pool associato all'ID pool che era stato timeout.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Il Driver Manager non elaborerà le informazioni diagnostiche restituite da SQLCleanupConnectionPoolID.

Un'applicazione non può ricevere il messaggio di errore restituito dal driver.

Osservazioni:

SQLCleanupConnectionPoolID può essere chiamato in qualsiasi momento, ma il Driver Manager garantisce che nessun altro thread stia chiamando contemporaneamente SQLGetPoolID e nessun altro thread stia chiamando contemporaneamente SQLRateConnection e SQLPoolConnect con un token di connessione assegnato a quell'ID pool. Pertanto, il driver deve assicurarsi che questa funzione sia sicura per thread.

Un autista può ripulire le risorse associate all'ID pool.

Le applicazioni non dovrebbero chiamare direttamente questa funzione. Un driver ODBC che supporta il pooling di connessioni consapevole del driver deve implementare questa funzione.

Includere sqlspi.h per lo sviluppo dei driver ODBC.

Contenuti correlati

  • Last updated on