[IWTSProtocolListener::StartListen 自 Windows Server 2012 起不再可用。 请改用 IWRdsProtocolListener::StartListen.]
通知协议开始侦听客户端连接请求。
语法
HRESULT StartListen(
[in] IWTSProtocolListenerCallback *pCallback
);
参数
[in] pCallback
指向由远程桌面服务服务实现的 IWTSProtocolListenerCallback 对象的指针。 协议使用 IWTSProtocolListenerCallback 对象来通知
有关传入连接请求的远程桌面服务。 协议必须添加对此对象的引用,并在调用 StopListen 时释放它。
返回值
实现此方法时,如果函数成功,则返回 S_OK 。 如果失败,则返回指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 常见 HRESULT 值。
注解
启动远程桌面服务服务时,将调用 StartListen 方法。
- 远程桌面服务调用 CoCreateInstance 来创建 IWTSProtocolManager 对象。
- 远程桌面服务在 IWTSProtocolManager 接口上调用 CreateListener。 该协议创建一个 IWTSProtocolListener 对象,并将其传递回远程桌面服务。
- 远程桌面服务对 IWTSProtocolListener 对象调用 StartListen。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2008 R2 |
| 目标平台 | Windows |
| 标头 | wtsprotocol.h |