Condividi tramite


SQLDriverConnect

Il driver ODBC di SQL Native Client definisce gli attributi di connessione che sostituiscono o migliorano le parole chiave delle stringhe di connessione. Varie parole chiave delle stringhe di connessione dispongono di valori predefiniti specificati dal driver ODBC di SQL Native Client.

Per un elenco di parole chiave disponibili nel driver ODBC di SQL Native Client, vedere Using Connection String Keywords with SQL Native Client.

Per ulteriori informazioni sugli attributi di connessione e sulle impostazioni predefinite di SQL Server, vedere SQLSetConnectAttr.

Se il valore del parametro SQLDriverConnectDriverCompletion è SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE o SQL_DRIVER_COMPLETE_REQUIRED, il driver ODBC di SQL Native Client recupera i valori delle parole chiave dalla finestra di dialogo visualizzata. Se il valore della parola chiave è passato nella stringa di connessione e l'utente non modifica tale valore nella finestra di dialogo, il driver ODBC di SQL Native Client utilizza il valore nella stringa di connessione. Se il valore non è impostato nella stringa di connessione e l'utente non esegue alcuna assegnazione nella finestra di dialogo, il driver utilizza il valore predefinito.

È necessario assegnare a SQLDriverConnect un oggetto WindowHandle valido se un valore DriverCompletion richiede o potrebbe richiedere che venga visualizzata la finestra di dialogo di connessione del driver. Un handle non valido restituisce SQL_ERROR.

Specificare la parola chiave DRIVER o DSN. Se entrambe tali parole chiave sono specificate, ODBC indica l'utilizzo di quella all'estrema sinistra da parte di un driver. Se è specificata DRIVER o tale parola chiave corrisponde a quella all'estrema sinistra e il valore del parametro SQLDriverConnectDriverCompletion è SQL_DRIVER_NOPROMPT, sono necessari la parola chiave SERVER e un relativo valore appropriato.

Se è specificato SQL_DRIVER_NOPROMPT, devono essere presenti le parole chiave di autenticazione utente con i relativi valori. Il driver garantisce la presenza della stringa "Trusted_Connection=yes" o di entrambe le parole chiave UID e PWD.

Se il valore del parametro DriverCompletion è SQL_DRIVER_NOPROMPT o SQL_DRIVER_COMPLETE_REQUIRED e il linguaggio o il database proviene dalla stringa di connessione e non è valido, SQLDriverConnect restituisce SQL_ERROR.

Se il valore del parametro DriverCompletion è SQL_DRIVER_NOPROMPT o SQL_DRIVER_COMPLETE_REQUIRED e il linguaggio o il database proviene dalle definizioni delle origini dati ODBC e non è valido, SQLDriverConnect utilizza il linguaggio o il database predefinito per l'ID utente specificato e restituisce SQL_SUCCESS_WITH_INFO.

Se il valore del parametro DriverCompletion è SQL_DRIVER_COMPLETE o SQL_DRIVER_PROMPT e il linguaggio o il database non è valido, SQLDriverConnect visualizza di nuovo la finestra di dialogo.

Esempi

La seguente chiamata illustra la quantità minore di dati richiesti per SQLDriverConnect:

SQLDriverConnect(hdbc, hwnd,
    (SQLTCHAR*) "DRIVER={SQL Native Client};" SQL_NTS, szOutConn,
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);

Le stringhe di connessione seguenti illustrano i dati minimi richiesti quando il valore del parametro DriverCompletion è SQL_DRIVER_NOPROMPT:

"DSN=Human Resources;UID=MyUserName;PWD=MyPassword"

"DSN=Human Resources;Trusted_Connection=yes"

"FILEDSN=HR_FDSN;UID=MyUserName;PWD=MyPassword"

"FILEDSN=HR_FDSN;Trusted_Connection=yes"

"DRIVER={SQL Native Client};SERVER=(local);UID=MyUserName;PWD=MyPassword"

"DRIVER={SQL Native Client};SERVER=(local);Trusted_Connection=yes"

Vedere anche

Concetti

ODBC API Implementation Details

Altre risorse

SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
Funzione SQLDriverConnect

Guida in linea e informazioni

Assistenza su SQL Server 2005