Método IWTSProtocolManager::CreateListener (wtsprotocol.h)
[IWTSProtocolManager::CreateListener não está mais disponível para uso a partir de Windows Server 2012. Em vez disso, use IWRdsProtocolManager::CreateListener.]
Solicita a criação de um objeto IWTSProtocolListener que escuta solicitações de conexão de cliente de entrada. O provedor de protocolo deve adicionar uma referência ao objeto IWTSProtocolListener antes de retornar. O serviço 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] IWTSProtocolListener **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 IWTSProtocolListener .
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 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
| 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 |