共用方式為


SQLBrowseConnect

適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

SQLBrowseConnect 使用可分類為三種連線資訊的關鍵詞。 對於每個關鍵詞,下表指出是否傳回有效值的清單,以及關鍵詞是否為選擇性。

層級 1

關鍵字 傳回的清單? 自選? 描述
DSN N/A No SQLDataSources傳回之數據源的名稱。 如果使用 DRIVER 關鍵詞,就無法使用 DSN 關鍵詞。
DRIVER N/A No SQL Server Native Client ODBC 驅動程序名稱為 {SQL Server Native Client 11}。 如果使用 DSN 關鍵詞,則無法使用 DRIVER 關鍵詞。

層級 2

關鍵字 傳回的清單? 自選? 描述
SERVER No 數據源所在網路上的伺服器名稱。 “(local)” 一詞可以輸入為伺服器,在此情況下,即使這是非網络版本,也可以使用 SQL Server 的本地副本。
UID No Yes 使用者登入標識碼。
PWD No 是 (取決於使用者) 使用者指定的密碼。
APP No Yes 呼叫 SQLBrowseConnect 的應用程式名稱。
WSID No Yes 工作站標識碼。 一般而言,這是應用程式執行所在的計算機網路名稱。

層級 3

關鍵字 傳回的清單? 自選? 描述
DATABASE Yes Yes SQL Server 資料庫的名稱。
LANGUAGE Yes Yes SQL Server 所使用的國家語言。

SQLBrowseConnect 會忽略儲存在 ODBC 數據源定義中的 DATABASE 和 LANGUAGE 關鍵詞值。 如果傳遞至 SQLBrowseConnect 之 連接字串 中指定的資料庫或語言無效,SQLBrowseConnect 會傳回SQL_NEED_DATA和層級 3 連線屬性。

呼叫 SQLSetConnectAttr設定的下列屬性會決定 SQLBrowseConnect傳回的結果集。

屬性 描述
SQL_COPT_SS_BROWSE_CONNECT 如果設定為 SQL_MORE_INFO_YES,SQLBrowseConnect 會傳回伺服器屬性的擴充字串。

以下是 SQLBrowseConnect傳回的擴充字串範例:



ServerName\InstanceName;Clustered:No;Version:8.00.131



在此字串中,分號會分隔伺服器的各種資訊片段。 使用逗號分隔不同的伺服器實例。
SQL_COPT_SS_BROWSE_SERVER 如果指定伺服器名稱, SQLBrowseConnect 會傳回所指定伺服器的資訊。 如果SQL_COPT_SS_BROWSE_SERVER設為 NULL,SQLBrowseConnect 會傳回網域中所有伺服器的資訊。



請注意,由於網路問題, SQLBrowseConnect 可能不會收到來自所有伺服器的及時回應。 因此,傳回的伺服器清單可能會因每個要求而有所不同。
SQL_COPT_SS_BROWSE_CACHE_DATA 當SQL_COPT_SS_BROWSE_CACHE_DATA屬性設定為SQL_CACHE_DATA_YES時,當緩衝區長度不夠大而無法保存結果時,您可以擷取區塊中的數據。 這個長度是在 BufferLength 自變數中指定給 SQLBrowseConnect。

當有更多數據可用時,會傳回SQL_NEED_DATA。 當沒有其他數據要擷取時,會傳回SQL_SUCCESS。

預設值為 SQL_CACHE_DATA_NO。

高可用性、災害復原的 SQLBrowseConnect 支援

如需使用 SQLBrowseConnect 連線到 Always On 可用性群組叢集的詳細資訊,請參閱 SQL Server Native Client Support for High Availability, Disaster Recovery

服務主體名稱的 SQLBrowseConnect 支援 (SPN)

開啟連線時,SQL Server Native Client 會將SQL_COPT_SS_MUTUALLY_AUTHENTICATED和SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD設定為用來開啟連線的驗證方法。

如需SPN的詳細資訊,請參閱用戶端連接 (ODBC) 中的服務主體名稱 (SPN)。

變更記錄

更新的內容
記載SQL_COPT_SS_BROWSE_CACHE_DATA。

另請參閱

SQLBrowseConnect 函式
ODBC API 實作詳細數據