分享方式：

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 實作詳細數據