Funzione SQLGetPoolID

  • Articolo

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

Riepilogo
SQLGetPoolID recupera l'ID del pool.

Sintassi

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Argomenti

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

pPoolID
[Output] ID pool, che viene usato per identificare un set di connessioni che possono essere usate in modo intercambiabile (possibilmente richiedendo una reimpostazione aggiuntiva).

Resi

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Quando SQLGetPoolID restituisce SQL_ERROR o SQL_SUCCESS_WITH_INFO, Gestione driver userà handleType di SQL_HANDLE_DBC_INFO_TOKEN e handle di hDbcInfoToken.

Osservazioni:

SQLGetPoolID viene usato per ottenere l'ID del pool in base a un set di informazioni di connessione (da SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo e SQLSetConnectInfo). Questo ID pool viene usato per identificare un set di connessioni che possono essere usate in modo intercambiabile (eventualmente richiedendo una reimpostazione aggiuntiva). L'ID pool verrà usato per identificare il pool di connessioni per tale gruppo di connessioni.

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

Ogni volta che un driver restituisce SQL_SUCCESS_WITH_INFO, Gestione driver otterrà le informazioni di diagnostica da hDbcInfoToken e restituirà SQL_SUCCESS_WITH_INFO all'applicazione in SQLConnect e SQLDriverConnect.

Le applicazioni non devono chiamare direttamente questa funzione. Un driver ODBC che supporta il pool di connessioni compatibile con driver deve implementare questa funzione.

Includere sqlspi.h per lo sviluppo di driver ODBC.

Vedi anche

Sviluppo di un driver ODBC
Pool di connessioni compatibile con il driver
Sviluppo del rilevamento di pool di connessioni in un driver ODBC