Herstellen einer Verbindung mit SQLBrowseConnect
SQLBrowse Verbinden wie SQLDriver Verbinden verwendet eine Verbindungszeichenfolge. Mithilfe von SQLBrowse Verbinden kann eine Anwendung jedoch eine vollständige Verbindungszeichenfolge zur Laufzeit erstellen. Dadurch kann die Anwendung zwei Funktionen erfüllen:
Erstellen Sie eigene Dialogfelder, um diese Informationen einzufordern, wodurch die Kontrolle über das "Aussehen und Verhalten" beibehalten wird.
Durchsuchen des Systems nach Datenquellen, die von einem bestimmten Treiber verwendet werden können. Dies sollte nach Möglichkeit in mehreren Schritten erfolgen. Beispielsweise kann der Benutzer zunächst das Netzwerk nach Servern durchsuchen und, sobald er einen Server ausgewählt hat, diesen nach Datenbanken durchsuchen, auf die der Treiber zugreifen kann.
Die Anwendung ruft SQLBrowse Verbinden auf und übergibt eine Verbindungszeichenfolge, die als Suchanforderung Verbindungszeichenfolge bezeichnet wird, die einen Treiber oder eine Datenquelle angibt. Der Treiber gibt einen Verbindungszeichenfolge zurück, der als Suchergebnis Verbindungszeichenfolge bezeichnet wird, das Schlüsselwort (keyword) enthält, mögliche Werte (wenn die Schlüsselwort (keyword) einen separaten Wertesatz akzeptiert) und benutzerfreundliche Namen. Die Anwendung erstellt ein Dialogfeld mit den benutzerfreundlichen Namen und fordert den Benutzer zur Eingabe von Werten auf. Anschließend wird eine neue Suchanforderung Verbindungszeichenfolge aus diesen Werten erstellt und an den Treiber mit einem anderen Aufruf von SQLBrowse Verbinden zurückgegeben.
Da Verbindungszeichenfolge ü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 SQLBrowse Verbinden zum ersten Mal aufruft, gibt der Treiber möglicherweise Schlüsselwort (keyword)s zurück, um den Benutzer zur Eingabe eines Servernamens aufzufordern. Wenn die Anwendung den Servernamen zurückgibt, gibt der Treiber möglicherweise Schlüsselwort (keyword) 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 SQLBrowse Verbinden ein neues Suchergebnis Verbindungszeichenfolge zurückgibt, wird SQL_NEED_DATA als Rückgabecode zurückgegeben. Dadurch wird der Anwendung mitgeteilt, dass der Verbindungsvorgang nicht abgeschlossen ist. Bis SQLBrowse Verbinden 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.