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

Solicita la creación de un objeto IWRdsProtocolListener que escucha las solicitudes de conexión de cliente entrantes. El proveedor de protocolos debe agregar una referencia al objeto IWRdsProtocolListener antes de devolver. 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] IWRdsProtocolListener **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 IWRdsProtocolListener .

Valor devuelto

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

Observaciones

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

Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	wtsprotocol.h

Consulte también

IWRdsProtocolManager