共用方式為


SQLBrowseConnect

SQLBrowseConnect 會使用可分類成三種連接資訊層級的關鍵字。下表針對每個關鍵字指出是否傳回有效值清單以及關鍵字是否為選擇性。

層級 1

關鍵字

傳回清單?

選擇性?

說明

DSN

N/A

SQLDataSources 所傳回的資料來源名稱。如果使用 DRIVER 關鍵字,就無法使用 DSN 關鍵字。

DRIVER

N/A

Microsoft® SQL Server Native Client ODBC 驅動程式名稱是 {SQL Server Native Client 10}。如果使用 DSN 關鍵字,就無法使用 DRIVER 關鍵字。

層級 2

關鍵字

傳回清單?

選擇性?

說明

SERVER

事件來源所在之網路上的伺服器名稱。可以輸入 "(local)" 這個詞彙做為伺服器,在這種情況下可以使用 SQL Server 的本機複本,即使這是非網路的版本。

UID

使用者登入識別碼。

PWD

是 (依使用者而定)

使用者指定的密碼。

APP

呼叫 SQLBrowseConnect 之應用程式的名稱。

WSID

工作站識別碼。一般而言,這是應用程式執行所在之電腦的網路名稱。

層級 3

關鍵字

傳回清單?

選擇性?

說明

DATABASE

SQL Server 資料庫的名稱。

LANGUAGE

SQL Server 所用的國家語言。

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

下列屬性是透過呼叫 SQLSetConnectAttr 而設定,這些屬性會決定 SQLBrowseConnect 所傳回的結果集。

屬性

說明

SQL_COPT_SS_BROWSE_CONNECT

如果設定為 SQL_MORE_INFO_YES,則在 SQL Server 2000 和較新的版本中,SQLBrowseConnect 會傳回伺服器屬性的擴充字串。

下列是在 SQL Server 2000 中,由 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 時,您可以在緩衝區長度不足以容納結果時,以片段的方式提取資料。這個長度是在 SQLBrowseConnect.BufferLength 引數中指定。

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

預設為 SQL_CACHE_DATA_NO。

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

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

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

變更記錄

更新的內容

已記載 SQL_COPT_SS_BROWSE_CACHE_DATA。