SQLBrowseConnect

Artikel
06/13/2017

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	–	Nein	Name der Datenquelle, die von SQLDataSources zurückgegeben wird. Das DSN-Schlüsselwort kann nicht verwendet werden, wenn das DRIVER-Schlüsselwort verwendet wird.
DRIVER	–	Nein	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. Der Begriff "(local)" kann als Server eingegeben werden. In diesem Fall kann eine lokale Kopie von SQL Server verwendet werden, auch wenn es sich um eine nicht vernetzte Version handelt.
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.

Level 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 Datenbank oder Sprache, die in der an SQLBrowseConnect übergebenen Verbindungszeichenfolge angegeben ist, ungültig ist, gibt SQLBrowseConnect SQL_NEED_DATA und die Verbindungsattribute der Ebene 3 zurück.

Die folgenden Attribute, die durch aufrufen von SQLSetConnectAttr festgelegt werden, bestimmen das von SQLBrowseConnect zurückgegebene Resultset.

Attribut	BESCHREIBUNG
SQL_COPT_SS_BROWSE_CONNECT	Wenn sie auf SQL_MORE_INFO_YES festgelegt ist, gibt SQLBrowseConnect eine erweiterte Zeichenfolge von Servereigenschaften zurück. Im Folgenden ist ein Beispiel für eine erweiterte Zeichenfolge aufgeführt, die von SQLBrowseConnect:ServerName\InstanceName zurückgegeben wird. Gruppiert:Nein; 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 für den angegebenen Server zurück. Wenn SQL_COPT_SS_BROWSE_SERVER auf NULL festgelegt ist, gibt SQLBrowseConnect Informationen für alle Server in der Domäne zurück. Aufgrund von Netzwerkproblemen erhält SQLBrowseConnect möglicherweise keine rechtzeitige 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 für SQLBrowseConnect angegeben. 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.