Compartilhar via


estrutura ACE_HEADER (winnt.h)

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)

Confira também

ACCESS_ALLOWED_ACE

ACCESS_ALLOWED_OBJECT_ACE

ACCESS_DENIED_ACE

ACCESS_DENIED_OBJECT_ACE

ACL

SYSTEM_AUDIT_ACE

SYSTEM_AUDIT_OBJECT_ACE