SQLBrowseConnect

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

層級 1

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

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

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

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

下列屬性是藉由呼叫 SQLSet 連線 Attr 來設定，決定 SQLBrowse 所傳回的結果集連線。

屬性	描述
SQL_COPT_SS_BROWSE_CONNECT	如果設定為 SQL_MORE_INFO_YES，SQLBrowse 連線會傳回伺服器屬性的擴充字串。以下是 SQLBrowse 所傳回的擴充字串範例連線： `ServerName\InstanceName;Clustered:No;Version:8.00.131` 在此字串中，分號會分隔伺服器的各種資訊片段。使用逗號分隔不同的伺服器實例。
SQL_COPT_SS_BROWSE_SERVER	如果指定伺服器名稱，SQLBrowse 連線會傳回所指定伺服器的資訊。如果SQL_COPT_SS_BROWSE_SERVER設為 NULL，SQLBrowse 連線會傳回網域中所有伺服器的資訊。請注意，由於網路問題，SQLBrowse 連線可能不會收到來自所有伺服器的及時回應。因此，傳回的伺服器清單可能會因每個要求而有所不同。
SQL_COPT_SS_BROWSE_CACHE_DATA	當SQL_COPT_SS_BROWSE_CACHE_DATA屬性設定為SQL_CACHE_DATA_YES時，當緩衝區長度不夠大而無法保存結果時，您可以擷取區塊中的數據。這個長度是在 BufferLength 自變數中指定給 SQLBrowse 連線。當有更多數據可用時，會傳回SQL_NEED_DATA。當沒有其他數據要擷取時，會傳回SQL_SUCCESS。預設值為 SQL_CACHE_DATA_NO。

如需使用 SQLBrowse 連線 連線到 AlwaysOn 可用性群組叢集的詳細資訊，請參閱 SQL Server Native Client Support for High Availability， Disaster Recovery。

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

更新的內容
記載SQL_COPT_SS_BROWSE_CACHE_DATA。