Partilhar via


Método IWTSProtocolListener::StartListen (wtsprotocol.h)

[IWTSProtocolListener::StartListen não está mais disponível para uso a partir de Windows Server 2012. Em vez disso, use IWRdsProtocolListener::StartListen.]

Notifica o protocolo para começar a escutar solicitações de conexão do cliente.

Sintaxe

HRESULT StartListen(
  [in] IWTSProtocolListenerCallback *pCallback
);

Parâmetros

[in] pCallback

Um ponteiro para um objeto IWTSProtocolListenerCallback implementado pelo serviço de Serviços de Área de Trabalho Remota. O protocolo usa o objeto IWTSProtocolListenerCallback para notificar o

Serviços de Área de Trabalho Remota sobre solicitações de conexão de entrada. O protocolo deve adicionar uma referência a esse objeto e liberá-lo quando StopListen for chamado.

Retornar valor

Quando você estiver implementando esse método, retorne S_OK se a função for bem-sucedida. Se falhar, retorne um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

O método StartListen é chamado quando o serviço de Serviços de Área de Trabalho Remota é iniciado.

  1. O serviço Serviços de Área de Trabalho Remota chama CoCreateInstance para criar um objeto IWTSProtocolManager .
  2. O serviço Serviços de Área de Trabalho Remota chama CreateListener na interface IWTSProtocolManager . O protocolo cria um objeto IWTSProtocolListener e o passa de volta para o serviço de Serviços de Área de Trabalho Remota.
  3. O serviço Serviços de Área de Trabalho Remota chama StartListen no objeto IWTSProtocolListener .

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho wtsprotocol.h

Confira também

IWTSProtocolListener