Compartilhar via


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

Solicita a criação de um objeto IWRdsProtocolListener que escuta solicitações de conexão de cliente de entrada. O provedor de protocolo deve adicionar uma referência ao objeto IWRdsProtocolListener antes de retornar. O serviço de Serviços de Área de Trabalho Remota libera a referência quando o serviço para ou o objeto ouvinte é excluído.

Sintaxe

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

Parâmetros

[in] wszListenerName

Um ponteiro para uma cadeia de caracteres que contém o GUID do Registro que especifica o ouvinte a ser criado.

[out] pProtocolListener

O endereço de um ponteiro para o objeto IWRdsProtocolListener .

Valor retornado

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 CreateListener é a primeira chamada que o serviço de Serviços de Área de Trabalho Remota faz em seu provedor de protocolo. O serviço procura no Registro na seguinte chave para localizar o GUID do ouvinte a ser criado:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Control
            Terminal Server
               WinStations
                  ListenerName
                     LoadableProtocol_Object

Requisitos

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

Confira também

IWRdsProtocolManager