Funzione SQLSetConnectInfo

  • Articolo

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

Riepilogo
SQLSetConnectInfo viene usato per impostare l'origine dati, l'ID utente e la password nel token di informazioni 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 );

Argomenti

TokenHandle
[Input] Handle del token.

ServerName
[Input] Nome origine 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 un'origine dati, vedere Scelta di un'origine dati o driver.

NameLength1
[Input] Lunghezza di *NomeServer in caratteri.

UserName
[Input] Identificatore utente.

NameLength2
[Input] Lunghezza di *UserName in caratteri.

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

NameLength3
[Input] Lunghezza di *Autenticazione in caratteri.

Resi

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Uguale a SQLConnect per gli errori 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