Funzione SQLSetDriverConnectInfo

Articolo
08/21/2023

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

Riepilogo
SQLSetDriverConnectInfo viene usato per impostare la stringa di connessione nel token delle informazioni di connessione per la chiamata a SQLDriverConnect di un'applicazione.

Sintassi

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );

Argomenti

TokenHandle
[Input] Handle del token.

InConnectionString
[Input] Stringa di connessione completa (vedere la sintassi in "Comments" in SQLDriverConnect), una stringa di connessione parziale o una stringa vuota.

StringLength1
[Input] Lunghezza di *InConnectionString, in caratteri se la stringa è Unicode o byte se la stringa è ANSI o DBCS.

Resi

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Uguale a SQLDriverConnect correlato a qualsiasi errore di convalida dell'input, ad eccezione del fatto che Gestione driver userà un HandleType di SQL_HANDLE_DBC_INFO_TOKEN e un handle di hDbcInfoToken.

Osservazioni:

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

Condividi tramite