IWTSProtocolManager::CreateListener 方法 (wtsprotocol.h)

[自Windows Server 2012起,IWTSProtocolManager::CreateListener 不再可供使用。 请改用 IWRdsProtocolManager::CreateListener。]

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

语法

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

参数

[in] wszListenerName

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

[out] pProtocolListener

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

返回值

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

注解

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

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Control
            Terminal Server
               WinStations
                  ListenerName
                     LoadableProtocol_Object

要求

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

另请参阅

IWTSProtocolManager