estrutura ACE_HEADER (ntifs.h)

Artigo
02/29/2024

A estrutura ACE_HEADER descreve o tipo e o tamanho de uma ACE (entrada de controle de acesso).

Sintaxe

typedef struct _ACE_HEADER {
  UCHAR  AceType;
  UCHAR  AceFlags;
  USHORT AceSize;
} ACE_HEADER;

Membros

AceType

Tipo ACE. Esse membro pode ser um dos seguintes valores:

Valor	Significado
ACCESS_ALLOWED_ACE_TYPE	ACE permitida pelo acesso que usa a estrutura ACCESS_ALLOWED_ACE.
ACCESS_DENIED_ACE_TYPE	ACE negado pelo acesso que usa a estrutura ACCESS_DENIED_ACE.
SYSTEM_AUDIT_ACE_TYPE	ACE de auditoria do sistema que usa a estrutura SYSTEM_AUDIT_ACE.

AceFlags

Conjunto de sinalizadores de controle específicos do tipo ACE. Esse membro pode ser uma combinação dos seguintes valores:

Valor	Significado
CONTAINER_INHERIT_ACE	Objetos filho que são contêineres, como diretórios, herdam a ACE como uma ACE efetiva. O ACE herdado é herdável, a menos que o sinalizador de bits NO_PROPAGATE_INHERIT_ACE também esteja definido.
FAILED_ACCESS_ACE_FLAG	Usado com ACEs de auditoria do sistema em uma SACL para gerar mensagens de auditoria para tentativas de acesso com falha.
INHERIT_ONLY_ACE	Indica uma ACE somente herdada que não controla o acesso ao objeto ao qual ele está anexado. Se esse sinalizador não estiver definido, o ACE será um ACE efetivo que controla o acesso ao objeto ao qual ele está anexado. AcEs efetivas e somente herdadas podem ser herdadas dependendo do estado dos outros sinalizadores de herança.
INHERITED_ACE	Microsoft Windows 2000 ou posterior: Indica que a ACE foi herdada. O sistema define esse bit quando propaga uma ACE herdada para um objeto filho.
NO_PROPAGATE_INHERIT_ACE	Se a ACE for herdada por um objeto filho, o sistema limpará os sinalizadores OBJECT_INHERIT_ACE e CONTAINER_INHERIT_ACE no ACE herdado. Isso impede que a ACE seja herdada por gerações subsequentes de objetos.
OBJECT_INHERIT_ACE	Objetos filho não pertencentes ao contêiner herdam o ACE como um ACE efetivo. Para objetos filho que são contêineres, a ACE é herdada como uma ACE somente herdada, a menos que o sinalizador de bits NO_PROPAGATE_INHERIT_ACE também esteja definido.
SUCCESSFUL_ACCESS_ACE_FLAG	Usado com ACEs de auditoria do sistema em uma SACL para gerar mensagens de auditoria para tentativas de acesso bem-sucedidas.

AceSize

Tamanho, em bytes, da ACE.

Comentários

A estrutura ACE_HEADER é o primeiro membro dos vários tipos de estruturas ACE, como ACCESS_ALLOWED_ACE.

Atualmente, não há suporte para ACEs de alarme do sistema. O membro AceType não pode especificar o SYSTEM_ALARM_ACE_TYPE. Não use a estrutura SYSTEM_ALARM_ACE.