Метод IWTSProtocolListener::StartListen (wtsprotocol.h)
[IWTSProtocolListener::StartListen больше недоступен для использования с Windows Server 2012. Вместо этого используйте IWRdsProtocolListener::StartListen.]
Уведомляет протокол о начале прослушивания запросов на подключение клиента.
Синтаксис
HRESULT StartListen(
[in] IWTSProtocolListenerCallback *pCallback
);
Параметры
[in] pCallback
Указатель на объект IWTSProtocolListenerCallback , реализованный службой служб удаленных рабочих столов. Протокол использует объект IWTSProtocolListenerCallback для уведомления
Служба служб удаленных рабочих столов о входящих запросах на подключение. Протокол должен добавить ссылку на этот объект и освободить его при вызове StopListen .
Возвращаемое значение
При реализации этого метода возвращайте S_OK , если функция выполнена успешно. В случае сбоя возвращается значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Комментарии
Метод StartListen вызывается при запуске службы удаленных рабочих столов.
- Служба удаленных рабочих столов вызывает CoCreateInstance для создания объекта IWTSProtocolManager .
- Служба удаленных рабочих столов вызывает CreateListener в интерфейсе IWTSProtocolManager . Протокол создает объект IWTSProtocolListener и передает его обратно в службу служб удаленных рабочих столов.
- Служба удаленных рабочих столов вызывает StartListen для объекта IWTSProtocolListener .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 R2 |
| Целевая платформа | Windows |
| Header | wtsprotocol.h |