Поделиться через


Метод 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 вызывается при запуске службы удаленных рабочих столов.

  1. Служба удаленных рабочих столов вызывает CoCreateInstance для создания объекта IWTSProtocolManager .
  2. Служба удаленных рабочих столов вызывает CreateListener в интерфейсе IWTSProtocolManager . Протокол создает объект IWTSProtocolListener и передает его обратно в службу служб удаленных рабочих столов.
  3. Служба удаленных рабочих столов вызывает StartListen для объекта IWTSProtocolListener .

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 R2
Целевая платформа Windows
Header wtsprotocol.h

См. также раздел

IWTSProtocolListener