SQLBrowseConnect
SQLBrowseConnect 使用可分類為三種連線資訊的關鍵字。 下表針對每個關鍵字指出是否傳回有效值清單以及關鍵字是否為選擇性。
層級 1
| 關鍵字 | 傳回清單？ | 選擇性？ | 描述 |
|---|---|---|---|
| DSN | N/A | 否 | SQLDataSources傳回的資料來源名稱。 如果使用 DRIVER 關鍵字，就無法使用 DSN 關鍵字。 |
| DRIVER | N/A | 否 | 微軟？？ SQL Server Native Client ODBC 驅動程式名稱為 {SQL Server Native Client 11}。 如果使用 DSN 關鍵字，就無法使用 DRIVER 關鍵字。 |
層級 2
| 關鍵字 | 傳回清單？ | 選擇性？ | 描述 |
|---|---|---|---|
| SERVER | 是 | No | 事件來源所在之網路上的伺服器名稱。 「 (本機) 」 一詞可以輸入為伺服器，在此情況下，即使這是非網路版本，也可以使用本機複本SQL Server。 |
| UID | No | 是 | 使用者登入識別碼。 |
| PWD | No | 是 (依使用者而定) | 使用者指定的密碼。 |
| APP | No | Yes | 呼叫 SQLBrowseConnect的應用程式名稱。 |
| WSID | No | Yes | 工作站識別碼。 一般而言，這是應用程式執行所在之電腦的網路名稱。 |
Level 3
| 關鍵字 | 傳回清單？ | 選擇性？ | 描述 |
|---|---|---|---|
| DATABASE | Yes | 是 | SQL Server 資料庫的名稱。 |
| LANGUAGE | 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：否;版本：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 時，您可以在緩衝區長度不足以容納結果時，以片段的方式提取資料。 這個長度是在 SQLBrowseConnect 的 BufferLength 引數中指定。 當有更多資料可用時，會傳回 SQL_NEED_DATA。 當沒有其他要擷取的資料時，會傳回 SQL_SUCCESS。 預設為 SQL_CACHE_DATA_NO。 |
高可用性/災害復原的 SQLBrowseConnect 支援
如需使用SQLBrowseConnect連線到Always On可用性群組叢集的詳細資訊，請參閱SQL Server Native Client高可用性、災害復原的支援。
服務主要名稱 (SPN) 的 SQLBrowseConnect 支援
開啟連線時，SQL Server Native Client會將SQL_COPT_SS_MUTUALLY_AUTHENTICATED和SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD設定為用來開啟連線的驗證方法。
如需 SPN 的詳細資訊，請參閱用戶端連線 中的服務主體名稱 (SPN) (ODBC) 。
變更記錄
| 更新的內容 |
|---|
| 已記載 SQL_COPT_SS_BROWSE_CACHE_DATA。 |