estrutura ACE_HEADER (winnt.h)

Artigo
08/27/2023

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

Sintaxe

typedef struct _ACE_HEADER {
  BYTE AceType;
  BYTE AceFlags;
  WORD AceSize;
} ACE_HEADER;

Membros

AceType

Especifica o tipo ACE. Esse membro pode ser um dos valores a seguir.

Valor	Significado
ACCESS_ALLOWED_ACE_TYPE	ACE permitida pelo acesso que usa a estrutura ACCESS_ALLOWED_ACE .
ACCESS_ALLOWED_CALLBACK_ACE_TYPE	ACE de retorno de chamada permitido pelo acesso que usa a estrutura ACCESS_ALLOWED_CALLBACK_ACE .
ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE	ACE de retorno de chamada com permissão de acesso específico ao objeto que usa a estrutura ACCESS_ALLOWED_CALLBACK_OBJECT_ACE .
ACCESS_ALLOWED_COMPOUND_ACE_TYPE	Reservado.
ACCESS_ALLOWED_OBJECT_ACE_TYPE	ACE com permissão de acesso específica ao objeto que usa a estrutura ACCESS_ALLOWED_OBJECT_ACE .
ACCESS_DENIED_ACE_TYPE	ACE negado pelo acesso que usa a estrutura ACCESS_DENIED_ACE .
ACCESS_DENIED_CALLBACK_ACE_TYPE	ACE de retorno de chamada negado pelo acesso que usa a estrutura ACCESS_DENIED_CALLBACK_ACE .
ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE	ACE de retorno de chamada de acesso negado específico ao objeto que usa a estrutura ACCESS_DENIED_CALLBACK_OBJECT_ACE .
ACCESS_DENIED_OBJECT_ACE_TYPE	ACE de acesso negado específico ao objeto que usa a estrutura ACCESS_DENIED_OBJECT_ACE .
ACCESS_MAX_MS_ACE_TYPE	O mesmo que SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_V2_ACE_TYPE	O mesmo que SYSTEM_ALARM_ACE_TYPE.
ACCESS_MAX_MS_V3_ACE_TYPE	Reservado.
ACCESS_MAX_MS_V4_ACE_TYPE	O mesmo que SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_OBJECT_ACE_TYPE	O mesmo que SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MIN_MS_ACE_TYPE	O mesmo que ACCESS_ALLOWED_ACE_TYPE.
ACCESS_MIN_MS_OBJECT_ACE_TYPE	O mesmo que ACCESS_ALLOWED_OBJECT_ACE_TYPE.
SYSTEM_ALARM_ACE_TYPE	Reservado para uso futuro. ACE de alarme do sistema que usa a estrutura SYSTEM_ALARM_ACE .
SYSTEM_ALARM_CALLBACK_ACE_TYPE	Reservado para uso futuro. ACE de retorno de chamada de alarme do sistema que usa a estrutura SYSTEM_ALARM_CALLBACK_ACE .
SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE	Reservado para uso futuro. ACE de retorno de chamada de alarme do sistema específico do objeto que usa a estrutura SYSTEM_ALARM_CALLBACK_OBJECT_ACE .
SYSTEM_ALARM_OBJECT_ACE_TYPE	Reservado para uso futuro. ACE de alarme do sistema específico do objeto que usa a estrutura SYSTEM_ALARM_OBJECT_ACE .
SYSTEM_AUDIT_ACE_TYPE	ACE de auditoria do sistema que usa a estrutura SYSTEM_AUDIT_ACE .
SYSTEM_AUDIT_CALLBACK_ACE_TYPE	ACE de retorno de chamada de auditoria do sistema que usa a estrutura SYSTEM_AUDIT_CALLBACK_ACE .
SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE	ACE de retorno de chamada de auditoria do sistema específico do objeto que usa a estrutura SYSTEM_AUDIT_CALLBACK_OBJECT_ACE .
SYSTEM_AUDIT_OBJECT_ACE_TYPE	ACE de auditoria de sistema específica do objeto que usa a estrutura SYSTEM_AUDIT_OBJECT_ACE .
SYSTEM_MANDATORY_LABEL_ACE_TYPE 0x11	ACE de rótulo obrigatório que usa a estrutura SYSTEM_MANDATORY_LABEL_ACE .

AceFlags

Especifica um conjunto de sinalizadores de controle específicos do tipo ACE. Esse membro pode ser uma combinação dos valores a seguir.

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 ( lista de controle de acesso do sistema ) 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	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

Especifica o 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 os valores SYSTEM_ALARM_ACE_TYPE ou SYSTEM_ALARM_OBJECT_ACE_TYPE. Não use as estruturas SYSTEM_ALARM_ACE ou SYSTEM_ALARM_OBJECT_ACE .

Requisitos


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)