Condividi tramite


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

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

ID di accesso dell'utente.

PWD

No

Sì (dipende dall'utente)

Password specificata dall'utente.

APP

No

Nome dell'applicazione che chiama SQLBrowseConnect.

WSID

No

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

Nome del database di SQL Server.

LANGUAGE

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:

ServerName\InstanceName;Clustered:No;Version:8.00.131

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.

NotaNota
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).

Cronologia modifiche

Aggiornamento del contenuto

Informazioni su SQL_COPT_SS_BROWSE_CACHE_DATA.