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。 |