Funzione SQLPoolConnect

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

Sommario
SQLPoolConnect viene utilizzato per creare una nuova connessione se nessuna connessione nel pool può essere riutilizzata.

Sintassi

  
SQLRETURN  SQLPoolConnect(  
                SQLHDBC              hDbc,  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              wszOutConnectString,  
                SQLSMALLINT          cchConnectStringBuffer,  
                SQLSMALLINT *        cchConnectStringLen );

Arguments

hDbc
[Input] La maniglia di connessione.

hDbcInfoToken
[Input] Il handle del token per la nuova richiesta di connessione applicativa.

wszOutConnectString
[Output] Puntatore a un buffer per la stringa di connessione completata. Al momento della connessione con successo alla sorgente dati di destinazione, questo buffer contiene la stringa di connessione completata. Le applicazioni dovrebbero allocare almeno 1.024 caratteri per questo buffer.

Se wszOutConnectString è NULL, cchConnectStringLen restituirà comunque il numero totale di caratteri (escludendo il carattere di null-termination per i dati caratteri) disponibili da restituire nel buffer indicato da wszOutConnectString.

cchConnectStringBuffer
[Input] Lunghezza del buffer *wszOutConnectString , in caratteri.

cchConnectStringLen
[Output] Puntatore a un buffer in cui restituire il numero totale di caratteri (escluso il carattere di null-termination) disponibili in *wszOutConnectString. Se il numero di caratteri disponibili da restituire è maggiore o uguale a cchConnectStringBuffer, la stringa di connessione completata in *wszOutConnectStringString viene troncata in cchConnectStringBuffer meno la lunghezza di un carattere null-termination.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, o, SQL_INVALID_HANDLE.

Diagnostica

Simile a SQLDriverConnect per qualsiasi errore di validazione di input, tranne che il Driver Manager utilizzerà un HandleType di SQL_HANDLE_DBC_INFO_TOKEN e un Handle di hDbcInfoToken.

Osservazioni:

Il Driver Manager garantisce che il handle HENV principale di hDbc e hDbcInfoToken sia lo stesso.

A differenza di SQLDriverConnect, non esiste un argomento DriverCompletion che inviti gli utenti a inserire le informazioni di connessione. Un dialogo di prompting è vietato nello scenario di pooling.

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

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.

Quando un'applicazione utilizza SQLConnect, wszOutConnectString sarà un buffer NULL (gli ultimi tre parametri saranno tutti impostati su NULL, 0, NULL). Altrimenti, il driver deve restituire la stringa di connessione di output, che verrà restituita alla chiamata SQLDriverConnect Function dell'applicazione.

Includere sqlspi.h per lo sviluppo dei driver ODBC.

Contenuti correlati

  • Last updated on