Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
SQLBrowseConnect usa parole chiave che possono essere classificate in tre livelli di informazioni di connessione. Per ogni parola chiave, la tabella seguente indica se viene restituito un elenco di valori validi e se la parola chiave è facoltativa.
Livello 1
| Parola chiave | Elenco restituito? | Facoltativa? | Descrizione |
|---|---|---|---|
| DSN | Non disponibile | NO | Nome dell'origine dati restituita da SQLDataSources. La parola chiave DSN non può essere utilizzata se viene usata la parola chiave DRIVER. |
| AUTISTA | Non disponibile | NO | Microsoft? Il nome del driver ODBC di SQL Server Native Client è {SQL Server Native Client 11}. La parola chiave DRIVER non può essere utilizzata se viene utilizzata la parola chiave DSN. |
Livello 2
| Parola chiave | Elenco restituito? | Facoltativa? | Descrizione |
|---|---|---|---|
| SERVER | Sì | NO | Nome del server nella rete in cui risiede l'origine dati. Il termine "(local)" può essere immesso come server, nel qual caso è possibile usare una copia locale di SQL Server, anche quando si tratta di una versione non di rete. |
| Identificatore Unico | NO | Sì | ID di accesso utente. |
| PWD | NO | Sì (dipende dall'utente) | Password specificata dall'utente. |
| APP | NO | Sì | Nome dell'applicazione che chiama SQLBrowseConnect. |
| WSID | NO | Sì | ID workstation. In genere, si tratta del nome di rete del computer in cui viene eseguita l'applicazione. |
Livello 3
| Parola chiave | Elenco restituito? | Facoltativa? | Descrizione |
|---|---|---|---|
| BANCA DATI | Sì | Sì | Nome del database di SQL Server. |
| LINGUA | Sì | Sì | Linguaggio nazionale usato da SQL Server. |
SQLBrowseConnect ignora i valori delle parole chiave DATABASE e LANGUAGE archiviate nelle definizioni dell'origine dati ODBC. Se il database o la lingua specificata nel stringa di connessione passato a SQLBrowseConnect non è valido, SQLBrowseConnect restituisce SQL_NEED_DATA e gli attributi di connessione di 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, SQLBrowseConnect restituisce una stringa estesa di proprietà del server. Di seguito è riportato un esempio di stringa estesa restituita da SQLBrowseConnect:ServerName\InstanceName; Clustered:No; Versione:8.00.131 In questa stringa, i punti e virgola separano varie informazioni sul server. Usare le virgole per separare istanze del server diverse. |
| SQL_COPT_SS_BROWSE_SERVER | Se viene specificato un nome server, SQLBrowseConnect restituirà informazioni per il server specificato. Se SQL_COPT_SS_BROWSE_SERVER è impostato su NULL, SQLBrowseConnect restituisce informazioni per tutti i server nel dominio. A causa di problemi di rete, SQLBrowseConnect potrebbe non ricevere una risposta tempestiva da tutti i server. Di conseguenza, l'elenco dei server restituiti può 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 viene specificata nell'argomento BufferLength in SQLBrowseConnect. SQL_NEED_DATA viene restituito quando sono disponibili più dati. SQL_SUCCESS viene restituito quando non sono presenti altri dati da recuperare. Il valore predefinito è SQL_CACHE_DATA_NO. |
Supporto di SQLBrowseConnect per la disponibilità elevata, ripristino di emergenza
Per altre informazioni sull'uso di SQLBrowseConnect per connettersi a un cluster dei gruppi di disponibilità AlwaysOn, vedere Supporto di SQL Server Native Client per la disponibilità elevata, ripristino di emergenza.
Supporto di SQLBrowseConnect per i nomi delle entità servizio (SPN)
Quando viene aperta una connessione, SQL Server Native Client imposta SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD al metodo di autenticazione usato per aprire la connessione.
Per altre informazioni sui nomi SPN, vedere Service Principal Names (SPN) in Client Connections (ODBC).
Cronologia delle modifiche
| Contenuto aggiornato |
|---|
| SQL_COPT_SS_BROWSE_CACHE_DATA documentati. |
Vedere anche
Funzione SQLBrowseConnect
Dettagli di implementazione dell'API ODBC