使用 SQLBrowseConnect 連線

SQLBrowseConnectSQLDriverConnect 一樣,使用連線字串。 然而,透過使用 SQLBrowseConnect,應用程式可以在執行時建構完整的連線字串。 這讓應用程式能做兩件事:

  • 建立自己的對話框來提示這些資訊,從而保留對「外觀與感覺」的控制權。

  • 在系統中搜尋可供特定驅動程式使用的資料來源,可能需要多個步驟。 例如,使用者可能先瀏覽網路中的伺服器,選擇伺服器後,再瀏覽驅動程式可存取的資料庫。

應用程式呼叫 SQLBrowseConnect ,並傳遞一個稱為 瀏覽請求連接字串的連接字串, 該字串指定驅動程式或資料來源。 驅動程式會回傳一個連接字串,稱為 瀏覽結果連接字串, 該字串包含關鍵字、可能的值(若關鍵字接受離散的值集合)以及使用者友善的名稱。 應用程式會建立一個包含使用者友善名稱的對話框,並提示使用者輸入數值。 接著它會從這些值建立新的 browse request connection 字串,並透過另一個 SQLBrowseConnect 呼叫回傳給驅動程式。

由於連接字串是來回傳遞的,驅動程式可以在應用程式回傳舊連線字串時,回傳新的連接字串,提供多層次的瀏覽。 例如,應用程式首次呼叫 SQLBrowseConnect 時,驅動程式可能會回傳關鍵字,提示使用者輸入伺服器名稱。 當應用程式回傳伺服器名稱時,驅動程式可能會回傳關鍵字,提示使用者使用資料庫。 瀏覽過程會在應用程式回傳資料庫名稱後完成。

每次 SQLBrowseConnect 回傳新的瀏覽結果連線字串時,都會以 SQL_NEED_DATA 作為回傳程式碼。 這告訴應用程式連線過程尚未完成。 在 SQLBrowseConnect 返回 SQL_SUCCESS 之前,該連線處於 Need Data 狀態,無法用於其他用途,例如設定連線屬性。 應用程式可透過呼叫 SQLDisconnect 終止連線瀏覽程序。

本節包含以下主題。