Estrutura de ACL (winnt.h)

Artigo
03/13/2024

A estrutura acl é o cabeçalho de uma ACL ( lista de controle de acesso ). Uma ACL completa consiste em uma estrutura de ACL seguida por uma lista ordenada de zero ou mais ACEs ( entradas de controle de acesso ).

Sintaxe

typedef struct _ACL {
  BYTE AclRevision;
  BYTE Sbz1;
  WORD AclSize;
  WORD AceCount;
  WORD Sbz2;
} ACL;

Membros

AclRevision

Especifica o nível de revisão da ACL. Esse valor deve ser ACL_REVISION, a menos que a ACL contenha um ACE específico do objeto, nesse caso, esse valor deve ser ACL_REVISION_DS. Todos os ACEs em uma ACL devem estar no mesmo nível de revisão.

Sbz1

Especifica um byte zero de preenchimento que alinha o membro AclRevision em um limite de 16 bits.

AclSize

Especifica o tamanho, em bytes, da ACL. Esse valor inclui a estrutura de ACL , todos os ACEs e a memória potencial não utilizado.

AceCount

Especifica o número de ACEs armazenados na ACL.

Sbz2

Especifica dois bytes zero de preenchimento que alinham a estrutura de ACL em um limite de 32 bits.

Comentários

Uma ACL inclui uma lista sequencial de zero ou mais ACEs. Os ACEs individuais em uma ACL são numerados de 0 a n, em que n+1 é o número de ACEs na ACL. Ao editar uma ACL, um aplicativo se refere a um ACE dentro da ACL pelo índice do ACE.

Há dois tipos de ACL: discricionário e sistema.

Uma DACL ( lista de controle de acesso discricionário ) é controlada pelo proprietário de um objeto ou qualquer pessoa concedida WRITE_DAC acesso ao objeto. Ela especifica o acesso que determinados usuários e grupos podem ter a um objeto. Por exemplo, o proprietário de um arquivo pode usar uma DACL para controlar quais usuários e grupos podem e não podem ter acesso ao arquivo.

Um objeto também pode ter informações de segurança no nível do sistema associadas a ele, na forma de uma SACL ( lista de controle de acesso do sistema ) controlada por um administrador do sistema. Uma SACL permite que o administrador do sistema audite todas as tentativas de obter acesso a um objeto.

Para obter uma lista de estruturas ACE definidas no momento, consulte ACE.

No momento, não há suporte para uma quarta estrutura ace, SYSTEM_ALARM_ACE.

A estrutura de ACL deve ser tratada como se fosse opaca e os aplicativos não tentem trabalhar diretamente com seus membros. Para garantir que as ACLs estejam semanticamente corretas, os aplicativos podem usar as funções listadas na seção Consulte Também para criar e manipular ACLs.

Cada acl e estrutura ACE começa em um limite DWORD .

O tamanho máximo de uma ACL, incluindo seus ACEs, é de 64 KB.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winnt.h (inclua Windows.h)