Funzione SQLSetDriverConnectInfo

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

Sommario
SQLSetDriverConnectInfo viene utilizzato per impostare la stringa di connessione nel connection info token per la chiamata SQLDriverConnect di un'applicazione.

Sintassi

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

Arguments

TokenHandle
[Input] Nickname del token.

InConnectionString
[Input] Una stringa di connessione completa (vedi la sintassi in "Commenti" in SQLDriverConnect), una stringa di connessione parziale o una stringa vuota.

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

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Lo stesso vale per SQLDriverConnect per qualsiasi errore di validazione di input, tranne che il Driver Manager 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, 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