Метод IWRdsProtocolManager::CreateListener (wtsprotocol.h)

Статья
08/28/2023

Запрашивает создание объекта 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

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