IRDPSRAPIViewer：：Connect 方法 (rdpencomapi.h)

[IRDPSRAPIViewer 介面已不再可供 UWP 應用程式使用，自 Windows 10 1709 版起使用。傳統型應用程式仍支援。]

啟動與共用者的實際連線。

語法

HRESULT Connect(
  [in] BSTR bstrConnectionString,
  [in] BSTR bstrName,
  [in] BSTR bstrPassword
);

[in] bstrConnectionString

類型： BSTR

用來連線到共用者的連接字串，並驗證查看器。

[in] bstrName

類型： BSTR

查看器的名稱。此名稱會傳送給共用者和其他檢視者。字串限制為 255 個字元。

[in] bstrPassword

類型： BSTR

用於驗證的密碼。密碼會從共用者傳出頻外。

類型： HRESULT

如果方法成功，傳回值 會S_OK。否則，傳回值是錯誤碼。

bstrConnectionString 參數中包含的連接字串是由共用者產生，並透過完成下列步驟由查看器取得：

共用者會從 IRDPSRAPISharingSession：：Invitations 屬性取得 IRDPSRAPIInvitationManager 介面的實例。
共用者會呼叫 IRDPSRAPIInvitationManager：：CreateInvitation 方法，以取得 IRDPSRAPIInvitation 介面的實例。
共用者會從 IRDPSRAPIInvitation：：ConnectionString 屬性取得連接字串。
共用程式會將連接字串傳送至應用程式定義方法中的查看器，例如將連接字串儲存在檔案中，並與查看器共用檔案。

為了提高安全性，應用程式可以將密碼與共用端的邀請產生關聯。這類密碼通常會透過用來傳送連接字串的一些機制，散發給檢視者。這是為了防止網路「探查」類型的攻擊。如果邀請有與其相關聯的密碼，則必須透過此 API 傳入密碼。否則，出席者將會中斷連線。

在啟動連接之後，此屬性中設定的 bstrName 字串會傳送至共用者。屬性是共用應用程式可以選擇顯示的易記名稱。當邀請用來驗證多個出席者時，此屬性很有用，因為它可讓共用者和其他檢視者識別參與 Windows 桌面共用會話的人員。