Compartilhar via

Função WTSGetListenerSecurityA (wtsapi32.h)

  • Artigo

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

Sintaxe

BOOL WTSGetListenerSecurityA(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPSTR                pListenerName,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

Parâmetros

[in] hServer

Um identificador para um servidor host de 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 recuperadas. Sempre habilite os sinalizadores DACL_SECURITY_INFORMATION e SACL_SECURITY_INFORMATION.

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

[out, optional] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que recebe as informações de segurança associadas ao ouvinte referenciado pelo parâmetro pListenerName . A estrutura SECURITY_DESCRIPTOR é retornada em formato auto-relativo. Para obter mais informações sobre valores possíveis, consulte SECURITY_DESCRIPTOR.

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 conexão.

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 logon.

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.

[in] nLength

O tamanho, em bytes, da estrutura de SECURITY_DESCRIPTOR referenciada pelo parâmetro pSecurityDescriptor.

[out] lpnLengthNeeded

Um ponteiro para uma variável que recebe o número de bytes necessários para armazenar o descritor de segurança completo. Se esse número for menor ou igual ao valor do parâmetro nLength, o descritor de segurança será copiado para a estrutura de SECURITY_DESCRIPTOR referenciada pelo parâmetro pSecurityDescriptor; caso contrário, nenhuma ação será tomada.

Valor de retorno

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.

Observações

Se o número de bytes necessários para o buffer que recebe a estrutura de SECURITY_DESCRIPTOR for desconhecido, você poderá chamar esse método com nLength definido como zero. Em seguida, o método retornará, no parâmetro lpnLengthNeeded, o número de bytes necessários para o buffer. Aloque o buffer com base nesse número e, em seguida, chame o método novamente, definindo pSecurityDescriptor para o buffer recém-alocado e nLength para o número retornado pela primeira chamada.

Nota

O cabeçalho wtsapi32.h define WTSGetListenerSecurity como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 7
servidor com suporte mínimo Windows Server 2008 R2
da Plataforma de Destino Windows
cabeçalho wtsapi32.h
biblioteca Wtsapi32.lib
de DLL Wtsapi32.dll

Consulte também

SECURITY_DESCRIPTOR

SECURITY_INFORMATION