Funzione SQLSetConnectInfo

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

Sommario
SQLSetConnectInfo viene utilizzato per impostare la fonte dati, l'ID utente e la password nel token di connessione per la chiamata SQLConnect di un'applicazione.

Sintassi

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );

Arguments

TokenHandle
[Input] Nickname del token.

Nome del Server
[Input] Nome della fonte dati. I dati potrebbero trovarsi nello stesso computer del programma o in un altro computer in una rete. Per informazioni su come un'applicazione sceglie una fonte dati, vedi Scelta di una fonte o di un driver dati.

NameLength1
[Input] Lunghezza di *ServerName in caratteri.

UserName
[Input] Identificatore utente.

NameLength2
[Input] Lunghezza di *UserName in caratteri.

Autenticazione
[Input] Stringa di autenticazione (tipicamente la password).

NameLength3
[Input] Lunghezza di *Autenticazione nei caratteri.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Lo stesso vale per SQLConnect per gli errori di validazione degli 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