Função WTSCreateListenerA (wtsapi32.h)
Cria um novo ouvinte dos Serviços de Área de Trabalho Remota ou configura um ouvinte existente.
Sintaxe
BOOL WTSCreateListenerA(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPSTR pListenerName,
[in] PWTSLISTENERCONFIGA pBuffer,
[in] DWORD flag
);
Parâmetros
[in] hServer
Um identificador para um servidor Host da Sessão de Área de Trabalho Remota. Sempre defina esse parâmetro como WTS_CURRENT_SERVER_HANDLE.
[in] pReserved
Esse parâmetro é reservado. Sempre defina esse parâmetro como NULL.
[in] Reserved
Esse parâmetro é reservado. Sempre defina esse parâmetro como zero.
[in] pListenerName
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do ouvinte a ser criado ou configurado.
[in] pBuffer
Um ponteiro para uma estrutura WTSLISTENERCONFIG que contém informações de configuração para o ouvinte.
[in] flag
A finalidade da chamada. Esse parâmetro pode usar um dos valores a seguir.
WTS_LISTENER_CREATE (1 (0x1))
Crie um ouvinte.
WTS_LISTENER_UPDATE (16 (0x10))
Atualize as configurações de um ouvinte existente.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame a função GetLastError.
Comentários
Essa função cria ou configura um ouvinte que usa o PROTOCOLO RDP. Sempre defina o membro de versão da estrutura WTSLISTENERCONFIG que é apontada pelo parâmetro pBuffer como um.
Essa função não cria nem configura o descritor de segurança do ouvinte. Quando você chama essa função para criar um ouvinte, a função atribui o descritor de segurança padrão ao novo ouvinte. Para modificar o descritor de segurança, chame a função WTSSetListenerSecurity . Para obter mais informações sobre descritores de segurança, consulte SECURITY_DESCRIPTOR.
Essa função não valida as configurações para o novo ouvinte. Verifique se as configurações são válidas antes de chamar essa função.
Observação
O cabeçalho wtsapi32.h define WTSCreateListener como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 |
| Servidor mínimo com suporte | Windows Server 2008 R2 |
| Plataforma de Destino | Windows |
| Cabeçalho | wtsapi32.h |
| Biblioteca | Wtsapi32.lib |
| DLL | Wtsapi32.dll |