SQLBrowseConnect
SQLBrowseConnect utilizza parole chiave che possono essere suddivise in tre livelli di informazioni di connessione. Per ogni parola chiave nella tabella seguente è indicato se viene restituito un elenco di valori validi e se la parola chiave è facoltativa.
Livello 1
Parola chiave |
Elenco restituito? |
Facoltativa? |
Descrizione |
|---|---|---|---|
DSN |
N/A |
No |
Nome dell'origine dati restituita da SQLDataSources. Se viene utilizzata la parola chiave DRIVER, non è possibile utilizzare la parola chiave DSN. |
DRIVER |
N/A |
No |
Il nome del driver ODBC di Microsoft® SQL Server Native Client è {SQL Server Native Client 10}. Se viene utilizzata la parola chiave DSN, non è possibile utilizzare la parola chiave DRIVER. |
Livello 2
Parola chiave |
Elenco restituito? |
Facoltativa? |
Descrizione |
|---|---|---|---|
SERVER |
Sì |
No |
Nome del server in rete nel quale risiede l'origine dati. È consentita la specifica del termine "(local)" per indicare il server. In questo caso, è possibile utilizzare una copia locale di SQL Server, anche quando si tratta di una versione non in rete. |
UID |
No |
Sì |
ID di accesso dell'utente. |
PWD |
No |
Sì (dipende dall'utente) |
Password specificata dall'utente. |
APP |
No |
Sì |
Nome dell'applicazione che chiama SQLBrowseConnect. |
WSID |
No |
Sì |
ID della workstation. In genere, si tratta del nome di rete del computer sul quale viene eseguita l'applicazione. |
Livello 3
Parola chiave |
Elenco restituito? |
Facoltativa? |
Descrizione |
|---|---|---|---|
DATABASE |
Sì |
Sì |
Nome del database di SQL Server. |
LANGUAGE |
Sì |
Sì |
Lingua nazionale utilizzata in SQL Server. |
SQLBrowseConnect ignora i valori delle parole chiave DATABASE e LANGUAGE archiviati nelle definizioni dell'origine dati ODBC. Se la lingua o il database specificato nella stringa di connessione passata a SQLBrowseConnect non è valido, SQLBrowseConnect restituisce SQL_NEED_DATA e gli attributi di connessione del livello 3.
Gli attributi seguenti, impostati chiamando SQLSetConnectAttr, determinano il set di risultati restituito da SQLBrowseConnect.
Attributo |
Descrizione |
|---|---|
SQL_COPT_SS_BROWSE_CONNECT |
Se impostato su SQL_MORE_INFO_YES, in SQL Server 2000 e versioni successive SQLBrowseConnect restituisce una stringa estesa delle proprietà del server. Di seguito è riportato un esempio di stringa estesa restituita da SQLBrowseConnect in SQL Server 2000: In questa stringa i punti e virgola separano le diverse informazioni sul server. Le virgole separano le diverse istanze del server. |
SQL_COPT_SS_BROWSE_SERVER |
Se viene specificato un nome di server, SQLBrowseConnect restituisce informazioni relative al server specificato. Se SQL_COPT_SS_BROWSE_SERVER è impostato su NULL, SQLBrowseConnect restituisce informazioni per tutti i server inclusi nel dominio. .gif "Nota") Nota
A causa di problemi di rete, SQLBrowseConnect potrebbe non ricevere una risposta tempestiva da tutti i server. L'elenco di server restituito può pertanto variare per ogni richiesta.
|
SQL_COPT_SS_BROWSE_CACHE_DATA |
Quando l'attributo SQL_COPT_SS_BROWSE_CACHE_DATA è impostato su SQL_CACHE_DATA_YES, è possibile recuperare i dati in blocchi quando la lunghezza del buffer non è sufficiente per contenere il risultato. Questa lunghezza è specificata nell'argomento BufferLength di SQLBrowseConnect. Quando sono disponibili più dati, viene restituito SQL_NEED_DATA. Quando non vi sono più dati da recuperare, viene restituito SQL_SUCCESS. Il valore predefinito è SQL_CACHE_DATA_NO. |
Supporto di SQLBrowseConnect per i nomi delle entità del servizio (SPN, Service Principal Name)
Quando si apre una connessione, SQL Server Native Client imposta SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD sul metodo di autenticazione utilizzato per aprire la connessione.
Per ulteriori informazioni sui nomi SPN, vedere Nomi SPN (Service Principal Name) nelle connessioni client (ODBC).
Vedere anche