Freigeben über


SQLBrowseConnect

SQLBrowseConnect verwendet Schlüsselwörter, die in drei Ebenen von Verbindungsinformationen kategorisiert werden können. In der folgenden Tabelle wird für jedes Schlüsselwort angegeben, ob eine Liste gültiger Werte zurückgegeben wird und ob das Schlüsselwort optional ist.

Ebene 1

Schlüsselwort

Liste zurückgegeben?

Optional?

Beschreibung

DSN

Nicht zutreffend

Nein

Name der von SQLDataSources zurückgegebenen Datenquelle. Das DSN-Schlüsselwort kann nicht verwendet werden, wenn das DRIVER-Schlüsselwort verwendet wird.

DRIVER

-

Nein

Der Microsoft® SQL Server Native Client-ODBC-Treibername ist {SQL Server Native Client 11}. Das DRIVER-Schlüsselwort kann nicht verwendet werden, wenn das DSN-Schlüsselwort verwendet wird.

Ebene 2

Schlüsselwort

Liste zurückgegeben?

Optional?

Beschreibung

SERVER

Ja

Nein

Name des Servers in dem Netzwerk, auf dem die Datenquelle gespeichert ist. Für den Server kann der Begriff "(local)" eingegeben werden. In diesem Fall kann eine lokale Kopie von SQL Server verwendet werden, auch wenn dies keine vernetzte Version ist.

UID

Nein

Ja

Benutzeranmelde-ID.

PWD

Nein

Ja (vom Benutzer abhängig)

Vom Benutzer angegebenes Kennwort.

APP

Nein

Ja

Name der Anwendung, die SQLBrowseConnect aufruft.

WSID

Nein

Ja

Workstation-ID. Dies ist normalerweise der Netzwerkname des Computers, auf dem die Anwendung ausgeführt wird.

Ebene 3

Schlüsselwort

Liste zurückgegeben?

Optional?

Beschreibung

DATABASE

Ja

Ja

Name der SQL Server-Datenbank.

LANGUAGE

Ja

Ja

Von SQL Server verwendete Landessprache.

SQLBrowseConnect ignoriert die Werte der Schlüsselwörter DATABASE und LANGUAGE, die in den ODBC-Datenquellendefinitionen gespeichert sind. Wenn die in der Verbindungszeichenfolge an SQLBrowseConnect übergebene Datenbank oder Sprache ungültig ist, gibt SQLBrowseConnect SQL_NEED_DATA sowie die Verbindungsattribute der Ebene 3 zurück.

Die folgenden, durch Aufruf von SQLSetConnectAttr festgelegten Attribute legen das von SQLBrowseConnect zurückgegebene Resultset fest.

Attribut

Beschreibung

SQL_COPT_SS_BROWSE_CONNECT

Wenn diese Option auf SQL_MORE_INFO_YES festgelegt wird, gibt SQLBrowseConnect eine erweiterte Zeichenfolge mit Servereigenschaften zurück.

Der folgende Code ist ein Beispiel für eine erweiterte Zeichenfolge, die von SQLBrowseConnect zurückgegeben wird.

ServerName\InstanceName;Clustered:No;Version:8.00.131

In dieser Zeichenfolge werden verschiedene durch Semikolons getrennte Informationen zum Server aufgeführt. Informationen zu verschiedenen Serverinstanzen werden durch Kommas getrennt.

SQL_COPT_SS_BROWSE_SERVER

Wenn ein Servername angegeben wird, gibt SQLBrowseConnect Informationen zum angegebenen Server zurück. Wenn für SQL_COPT_SS_BROWSE_SERVER NULL festgelegt wird, gibt SQLBrowseConnect Informationen für alle Server in der Domäne zurück.

HinweisHinweis

Aufgrund von Netzwerkproblemen erhält SQLBrowseConnect möglicherweise keine zeitgerechte Antwort von allen Servern. Daher kann die Liste der zurückgegebenen Server bei jeder Anforderung unterschiedlich sein.

SQL_COPT_SS_BROWSE_CACHE_DATA

Wenn die Pufferlänge nicht groß genug ist, um das Ergebnis aufzunehmen, können Sie das Attribut SQL_COPT_SS_BROWSE_CACHE_DATA auf SQL_CACHE_DATA_YES festlegen und Daten in Abschnitten abrufen. Diese Länge wird im BufferLength-Argument von SQLBrowseConnect festgelegt.

Wenn weitere Daten verfügbar sind, wird SQL_NEED_DATA zurückgegeben. Wenn keine weiteren Daten abrufbar sind, wird SQL_SUCCESS zurückgegeben.

Der Standardwert ist SQL_CACHE_DATA_NO.

SQLBrowseConnect-Unterstützung für hohe Verfügbarkeit, Wiederherstellung im Notfall

Weitere Informationen zur Verwendung von SQLBrowseConnect zum Herstellen einer Verbindung mit einem AlwaysOn-Verfügbarkeitsgruppen-Cluster finden Sie unter SQL Server Native Client-Unterstützung für hohe Verfügbarkeit, Notfallwiederherstellung.

SQLBrowseConnect-Unterstützung für Dienstprinzipalnamen (Service Principal Names, SPNs)

Wenn eine Verbindung hergestellt wird, legt SQL Server Native Client für SQL_COPT_SS_MUTUALLY_AUTHENTICATED und SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD die für das Herstellen der Verbindung zu verwendende Authentifizierungsmethode fest.

Weitere Informationen zu SPNs finden Sie unter Dienstprinzipalnamen (SPN) in Clientverbindungen (ODBC).

Siehe auch

Konzepte

ODBC-API-Implementierungsdetails

Andere Ressourcen

SQLBrowseConnect-Funktion

Änderungsverlauf

Aktualisierter Inhalt

Dokumentierte SQL_COPT_SS_BROWSE_CACHE_DATA.