Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
SQLBrowseConnect, z. B. SQLDriverConnect, verwendet eine Verbindungszeichenfolge. Mithilfe von SQLBrowseConnect kann eine Anwendung jedoch zur Laufzeit eine vollständige Verbindungszeichenfolge erstellen. Auf diese Weise kann die Anwendung zwei Dinge ausführen:
Erstellen Sie eigene Dialogfelder, um nach diesen Informationen zu fragen und so die Kontrolle über das "Aussehen und die Bedienung" zu behalten.
Durchsuchen Sie das System nach Datenquellen, die von einem bestimmten Treiber verwendet werden können, möglicherweise in mehreren Schritten. Beispielsweise kann der Benutzer zuerst das Netzwerk nach Servern durchsuchen und nach der Auswahl eines Servers den Server nach Datenbanken durchsuchen, auf die der Treiber zugreifen kann.
Die Anwendung ruft SQLBrowseConnect auf und übergibt eine Verbindungszeichenfolge, die als Verbindungszeichenfolge für die Browseanforderung bezeichnet wird, die einen Treiber oder eine Datenquelle angibt. Der Treiber gibt eine Verbindungszeichenfolge zurück, die als Suchergebnisverbindungszeichenfolge bezeichnet wird, die Schlüsselwörter, mögliche Werte (wenn das Schlüsselwort einen separaten Wertesatz akzeptiert) und benutzerfreundliche Namen enthält. Die Anwendung erstellt ein Dialogfeld mit den benutzerfreundlichen Namen und fordert den Benutzer zur Eingabe von Werten auf. Anschließend wird eine neue Verbindungszeichenfolge für die Browseanforderung aus diesen Werten erstellt und an den Treiber mit einem anderen Aufruf von SQLBrowseConnect zurückgegeben.
Da Verbindungszeichenfolgen hin und her übergeben werden, kann der Treiber mehrere Browserebenen bereitstellen, indem eine neue Verbindungszeichenfolge zurückgegeben wird, wenn die Anwendung die alte zurückgibt. Wenn eine Anwendung beispielsweise SQLBrowseConnect zum ersten Mal aufruft, gibt der Treiber möglicherweise Schlüsselwörter zurück, um den Benutzer zur Eingabe eines Servernamens aufzufordern. Wenn die Anwendung den Servernamen zurückgibt, gibt der Treiber möglicherweise Schlüsselwörter zurück, um den Benutzer zur Eingabe einer Datenbank aufzufordern. Der Browservorgang wäre abgeschlossen, nachdem die Anwendung den Datenbanknamen zurückgegeben hat.
Jedes Mal, wenn SQLBrowseConnect eine neue Suchergebnisverbindungszeichenfolge zurückgibt, wird SQL_NEED_DATA als Rückgabecode zurückgegeben. Dadurch wird der Anwendung mitgeteilt, dass der Verbindungsvorgang nicht abgeschlossen ist. Bis SQLBrowseConnect SQL_SUCCESS zurückgibt, befindet sich die Verbindung in einem Need Data-Zustand und kann nicht für andere Zwecke verwendet werden, z. B. zum Festlegen eines Verbindungsattributes. Die Anwendung kann den Verbindungsbrowsenprozess beenden, indem SQLDisconnect aufgerufen wird.
Dieser Abschnitt enthält das folgende Thema.