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

[IWTSProtocolManager::CreateListener больше недоступен для использования с Windows Server 2012. Вместо этого используйте IWRdsProtocolManager::CreateListener.]

Запрашивает создание объекта IWTSProtocolListener , который прослушивает входящие запросы на подключение клиента. Поставщик протокола должен добавить ссылку на объект IWTSProtocolListener перед возвратом. Служба удаленных рабочих столов освобождает ссылку при остановке службы или удалении объекта прослушивателя.

Синтаксис

HRESULT CreateListener(
  [in]  WCHAR                *wszListenerName,
  [out] IWTSProtocolListener **pProtocolListener
);

Параметры

[in] wszListenerName

Указатель на строку, содержащую guid реестра, указывающий создаваемый прослушиватель.

[out] pProtocolListener

Адрес указателя на объект IWTSProtocolListener .

Возвращаемое значение

При реализации этого метода возвращайте S_OK , если функция выполнена успешно. В случае сбоя возвращается значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Комментарии

Метод CreateListener является первым вызовом службы удаленных рабочих столов в поставщике протокола. Служба выполняет поиск в реестре в следующем разделе, чтобы найти GUID создаваемого прослушивателя:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Control
            Terminal Server
               WinStations
                  ListenerName
                     LoadableProtocol_Object

Требования

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

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

IWTSProtocolManager