struttura ACE_HEADER (ntifs.h)

Articolo
02/07/2025

La struttura ACE_HEADER descrive il tipo e le dimensioni di una voce di controllo di accesso (ACE).

Sintassi

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

Membri

AceType

Tipo ACE. Questo membro può essere uno dei valori seguenti:

Valore	Significato
ACCESS_ALLOWED_ACE_TYPE	Ace consentito dall'accesso che usa la struttura ACCESS_ALLOWED_ACE.
ACCESS_DENIED_ACE_TYPE	ACE negato dall'accesso che usa la struttura ACCESS_DENIED_ACE.
SYSTEM_AUDIT_ACE_TYPE	Ace di controllo di sistema che usa la struttura SYSTEM_AUDIT_ACE.

AceFlags

Set di flag di controllo specifici del tipo ACE. Questo membro può essere una combinazione dei valori seguenti:

Valore	Significato
CONTAINER_INHERIT_ACE	Gli oggetti figlio che sono contenitori, ad esempio le directory, ereditano l'ace come ace efficace. L'ace ereditato è ereditabile a meno che non sia impostato anche il flag di bit NO_PROPAGATE_INHERIT_ACE.
FAILED_ACCESS_ACE_FLAG	Usato con gli ACL di controllo di sistema in un sacl per generare messaggi di controllo per i tentativi di accesso non riusciti.
INHERIT_ONLY_ACE	Indica un ace di sola eredita che non controlla l'accesso all'oggetto a cui è collegato. Se questo flag non è impostato, l'ace è un ace efficace che controlla l'accesso all'oggetto a cui è collegato. Gli ACL effettivi ed ereditabili possono essere ereditati a seconda dello stato degli altri flag di ereditarietà.
INHERITED_ACE	Microsoft Windows 2000 o versione successiva: Indica che l'ace è stato ereditato. Il sistema imposta questo bit quando propaga un ace ereditato a un oggetto figlio.
NO_PROPAGATE_INHERIT_ACE	Se l'ace viene ereditato da un oggetto figlio, il sistema cancella il OBJECT_INHERIT_ACE e i flag CONTAINER_INHERIT_ACE nell'ace ereditato. Ciò impedisce che l'ace venga ereditato dalle generazioni successive di oggetti.
OBJECT_INHERIT_ACE	Gli oggetti figlio non contenitore ereditano l'ace come ace efficace. Per gli oggetti figlio che sono contenitori, l'ace viene ereditato come ace di sola eredita, a meno che non sia impostato anche il flag di bit NO_PROPAGATE_INHERIT_ACE.
SUCCESSFUL_ACCESS_ACE_FLAG	Usato con gli ACL di controllo di sistema in un sacl per generare messaggi di controllo per i tentativi di accesso riusciti.

AceSize

Dimensioni, in byte, dell'ace.

Osservazioni

La struttura ACE_HEADER è il primo membro dei vari tipi di strutture ACE, ad esempio ACCESS_ALLOWED_ACE.

Gli ACL di allarme di sistema non sono attualmente supportati. Il membro AceType non può specificare il SYSTEM_ALARM_ACE_TYPE. Non utilizzare la struttura SYSTEM_ALARM_ACE.