Função WTSSetListenerSecurityA (wtsapi32.h)

  • Artigo

Configura o descritor de segurança de um ouvinte dos Serviços de Área de Trabalho Remota.

Sintaxe

BOOL WTSSetListenerSecurityA(
  [in] HANDLE               hServer,
  [in] PVOID                pReserved,
  [in] DWORD                Reserved,
  [in] LPSTR                pListenerName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

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.

[in] SecurityInformation

Um valor SECURITY_INFORMATION que especifica as informações de segurança a serem definidas. Sempre habilite os sinalizadores DACL_SECURITY_INFORMATION e SACL_SECURITY_INFORMATION .

Para obter mais informações sobre valores possíveis, consulte SECURITY_INFORMATION.

[in] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que contém as informações de segurança associadas ao ouvinte. Para obter mais informações sobre valores possíveis, consulte SECURITY_DESCRIPTOR. Para obter informações sobre STANDARD_RIGHTS_REQUIRED, consulte Direitos de Acesso Padrão.

A DACL (lista de controle de acesso discricionário) do descritor de segurança pode conter um ou mais dos valores a seguir.

WTS_SECURITY_ALL_ACCESS

Combina estes valores:

  • STANDARD_RIGHTS_REQUIRED
  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGON
  • WTS_SECURITY_MESSAGE
  • WTS_SECURITY_QUERY_INFORMATION
  • WTS_SECURITY_REMOTE_CONTROL
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CONNECT (256 (0x100))

O direito de se conectar.

WTS_SECURITY_CURRENT_GUEST_ACCESS

Combina estes valores:

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

Combina estes valores:

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512 (0x200))

O direito de desconectar.

WTS_SECURITY_GUEST_ACCESS

Definido como WTS_SECURITY_LOGON.

WTS_SECURITY_LOGOFF (64 (0x40))

O direito de fazer logoff.

WTS_SECURITY_LOGON (32 (0x20))

O direito de fazer logon.

WTS_SECURITY_MESSAGE (128 (0x80))

O direito de enviar uma mensagem ao usuário.

WTS_SECURITY_QUERY_INFORMATION (1 (0x1))

O direito de consultar informações.

WTS_SECURITY_REMOTE_CONTROL (16 (0x10))

O direito de usar o controle remoto.

WTS_SECURITY_RESET (4 (0x4))

O direito de redefinir informações.

WTS_SECURITY_SET_INFORMATION (2 (0x2))

O direito de definir informações.

WTS_SECURITY_USER_ACCESS

Combina estes valores:

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))

O direito de usar canais virtuais.

Valor retornado

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

Observação

O cabeçalho wtsapi32.h define WTSSetListenerSecurity 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

   
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

Confira também

SECURITY_DESCRIPTOR

SECURITY_INFORMATION