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


Метод 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
Header wtsprotocol.h

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

IWRdsProtocolManager