共用方式為

IRDPSRAPIViewer：：StartReverseConnectListener 方法 (rdpencomapi.h)

  • 發行項

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

起始接聽程式以接受從共用器到檢視器的反向連線，或取得共用者用來反向連線至檢視器的連接字串。

語法

HRESULT StartReverseConnectListener(
  [in]  BSTR bstrConnectionString,
  [in]  BSTR bstrUserName,
  [in]  BSTR bstrPassword,
  [out] BSTR *pbstrReverseConnectString
);

參數

[in] bstrConnectionString

類型： BSTR

共用者將用來啟動接聽程式的連接字串。

[in] bstrUserName

類型： BSTR

要用於驗證的使用者名稱。

[in] bstrPassword

類型： BSTR

要用於驗證的密碼。

[out] pbstrReverseConnectString

類型： BSTR*

BSTR的指標，接收共用者可用來反向連線至檢視器的連接字串，方法是使用IRDPSRAPISharingSession：：ConnectToClient方法。

傳回值

類型： HRESULT

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

備註

這個方法可用來執行兩個不同的作業：

  • 第一個是讓檢視器取得共用者用來反向連接到檢視器的連接字串。 若要這樣做， bstrConnectionString、 bstrUserName和 bstrPassword 參數都必須是 Null。 然後，檢視器會將此連接字串傳送至應用程式定義方法中的共用器，例如將連接字串儲存在檔案中，並與共享者共用檔案。
  • 第二個作業是起始接聽程式，此接聽程式會watch共用者進行反向連線嘗試。 針對此作業， pbstrReverseConnectString 參數必須是 Null。
此程式的一般事件順序如下：
  1. 檢視器會藉由呼叫StartReverseConnectListener方法來取得其連接字串，並傳遞bstrConnectionString、bstrUserName和bstrPassword參數的Null。
  2. 檢視器會呼叫StartReverseConnectListener方法來起始反向連接接聽程式，並傳遞pbstrReverseConnectString參數的Null，以及bstrConnectionString、bstrUserName和bstrPassword參數的有效值。
  3. 檢視器會將步驟 1 中取得的連接字串傳送給共用者。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 rdpencomapi.h
Dll RdpEncom.dll

另請參閱

IRDPSRAPIViewer