estrutura ACE_HEADER (ntifs.h)

Artigo
02/07/2025

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 de 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 o ACE como um ACE efetivo. 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 um SACL para gerar mensagens de auditoria para tentativas de acesso com falha.
INHERIT_ONLY_ACE	Indica um ACE somente herdado 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. As 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 o ACE foi herdado. O sistema define esse bit quando propaga um ACE herdado para um objeto filho.
NO_PROPAGATE_INHERIT_ACE	Se o ACE for herdado por um objeto filho, o sistema limpará os sinalizadores OBJECT_INHERIT_ACE e CONTAINER_INHERIT_ACE no ACE herdado. Isso impede que o ACE seja herdado por gerações subsequentes de objetos.
OBJECT_INHERIT_ACE	Objetos filho não pertencentes herdam o ACE como um ACE efetivo. Para objetos filho que são contêineres, o ACE é herdado como um ACE somente herdado, 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 um SACL para gerar mensagens de auditoria para tentativas de acesso bem-sucedidas.

AceSize

Tamanho, em bytes, do ACE.

Observações

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

No momento, 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 de SYSTEM_ALARM_ACE.