Método IWTSProtocolManager::CreateListener (wtsprotocol.h)

[IWTSProtocolManager::CreateListener ya no está disponible para su uso a partir de Windows Server 2012. En su lugar, use IWRdsProtocolManager::CreateListener.]

Solicita la creación de un objeto IWTSProtocolListener que escucha las solicitudes de conexión de cliente entrantes. El proveedor de protocolos debe agregar una referencia al objeto IWTSProtocolListener antes de devolverlo. El servicio Servicios de Escritorio remoto libera la referencia cuando el servicio se detiene o se elimina el objeto de agente de escucha.

Sintaxis

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

Parámetros

[in] wszListenerName

Puntero a una cadena que contiene el GUID del Registro que especifica el agente de escucha que se va a crear.

[out] pProtocolListener

Dirección de un puntero al objeto IWTSProtocolListener .

Valor devuelto

Al implementar este método, devuelva S_OK si la función se realiza correctamente. Si se produce un error, devuelva un valor HRESULT que indique el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

El método CreateListener es la primera llamada que realiza el servicio Servicios de Escritorio remoto en el proveedor de protocolos. El servicio busca en el registro en la siguiente clave para buscar el GUID del agente de escucha que se va a crear:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Control
            Terminal Server
               WinStations
                  ListenerName
                     LoadableProtocol_Object

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	wtsprotocol.h

Consulte también

IWTSProtocolManager