Funzione SQLPoolConnect

Articolo
08/21/2023

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

Riepilogo
SQLPoolConnect viene usato per creare una nuova connessione se non è possibile riutilizzare alcuna connessione nel pool.

Sintassi

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

Argomenti

Hdbc
[Input] Handle di connessione.

hDbcInfoToken
[Input] Handle di token per la nuova richiesta di connessione dell'applicazione.

wszOutConnectString
[Output] Puntatore a un buffer per la stringa di connessione completata. Al termine della connessione all'origine dati di destinazione, questo buffer contiene la stringa di connessione completata. Le applicazioni devono allocare almeno 1.024 caratteri per questo buffer.

Se wszOutConnectString è NULL, cchConnectStringLen restituirà comunque il numero totale di caratteri (escluso il carattere di terminazione Null per i dati di tipo carattere) da restituire nel buffer a cui punta 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 terminazione Null) disponibile per la restituzione in *wszOutConnectString. Se il numero di caratteri disponibili per la restituzione è maggiore o uguale a cchConnectStringBuffer, la stringa di connessione completata in *wszOutConnectString viene troncata a cchConnectStringBuffer meno la lunghezza di un carattere di terminazione Null.

Resi

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Analogamente a SQLDriverConnect per qualsiasi errore di convalida dell'input, ad eccezione del fatto che Gestione driver userà handleTypedi SQL_HANDLE_DBC_INFO_TOKEN e handle di hDbcInfoToken.

Osservazioni:

Gestione driver garantisce che l'handle HENV padre di hDbc e hDbcInfoToken sia lo stesso.

A differenza di SQLDriverConnect, non esiste alcun argomento DriverCompletion per richiedere agli utenti di immettere le informazioni di connessione. Un dialogo di richiesta non è consentito nello scenario di pooling.

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

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.

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

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

Condividi tramite