通过

IRDPSRAPIViewer：：StartReverseConnectListener 方法 (rdpencomapi.h)

  • 项目

[自 Windows 10 版本 1709 起，IRDPSRAPIViewer 接口不再可用于 UWP 应用程序。 桌面应用仍支持它。]

启动侦听器以接受从共享者到查看器的反向连接，或获取共享者用于反向连接到查看器的连接字符串。

语法

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

parameters

[in] bstrConnectionString

类型： BSTR

共享者将用于启动侦听器的连接字符串。

[in] bstrUserName

类型： BSTR

用于身份验证的用户名。

[in] bstrPassword

类型： BSTR

用于身份验证的密码。

[out] pbstrReverseConnectString

类型： BSTR*

指向 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