IWRdsProtocolManager::CreateListener 方法 (wtsprotocol.h)

请求创建侦听传入客户端连接请求的 IWRdsProtocolListener 对象。 协议提供程序必须在返回之前添加对 IWRdsProtocolListener 对象的引用。 远程桌面服务服务在服务停止或删除侦听器对象时释放引用。

语法

HRESULT CreateListener(
  [in]  WCHAR                 *wszListenerName,
  [out] IWRdsProtocolListener **pProtocolListener
);

参数

[in] wszListenerName

指向字符串的指针,该字符串包含指定要创建的侦听器的注册表 GUID。

[out] pProtocolListener

指向 IWRdsProtocolListener 对象的指针的地址。

返回值

实现此方法时,如果函数成功,则返回 S_OK 。 如果失败,则返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 通用 HRESULT 值

注解

CreateListener 方法是远程桌面服务服务对协议提供程序进行的第一次调用。 该服务在注册表中查找以下项下,以查找要创建的侦听器的 GUID:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Control
            Terminal Server
               WinStations
                  ListenerName
                     LoadableProtocol_Object

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 wtsprotocol.h

另请参阅

IWRdsProtocolManager