Funzione SQLGetPoolID

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

Sommario
SQLGetPoolID recupera l'ID del pool.

Sintassi

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Arguments

hDbcInfoToken
[Input] Handle di token che contiene tutte le informazioni di connessione.

pPoolID
[Output] L'ID del pool, che viene utilizzato per identificare un insieme di connessioni che possono essere usate in modo intercambiabile (possibilmente richiedendo un ulteriore reset).

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Quando SQLGetPoolID restituisce SQL_ERROR o SQL_SUCCESS_WITH_INFO, il Driver Manager utilizzerà un HandleType di SQL_HANDLE_DBC_INFO_TOKEN e un Handle di hDbcInfoToken.

Osservazioni:

SQLGetPoolID viene utilizzato per ottenere l'ID del pool dato un insieme di informazioni di connessione (da SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo e SQLSetConnectInfo). Questo ID del pool viene utilizzato per identificare un insieme di connessioni che possono essere usate in modo intercambiabile (possibilmente richiedendo un reset aggiuntivo). L'ID del pool verrà usato per identificare il pool di connessione per quel gruppo di connessioni.

Ogni volta che un driver restituisce SQL_ERROR o SQL_INVALID_HANDLE, il Driver Manager restituisce l'errore all'applicazione (in SQLConnect o SQLDriverConnect).

Ogni volta che un driver restituisce SQL_SUCCESS_WITH_INFO, il Driver Manager otterrà le informazioni diagnostiche da hDbcInfoToken e restituirà SQL_SUCCESS_WITH_INFO all'applicazione in SQLConnect e SQLDriverConnect.

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