ACE_HEADER Struktur (ntifs.h)

Artikel
02/07/2025

Die ACE_HEADER Struktur beschreibt den Typ und die Größe eines Zugriffssteuerungseintrags (Access Control Entry, ACE).

Syntax

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

Angehörige

AceType

ACE-Typ. Dieses Element kann einer der folgenden Werte sein:

Wert	Bedeutung
ACCESS_ALLOWED_ACE_TYPE	Access-zulässige ACE, die die ACCESS_ALLOWED_ACE Struktur verwendet.
ACCESS_DENIED_ACE_TYPE	Zugriff verweigert ACE, die die ACCESS_DENIED_ACE Struktur verwendet.
SYSTEM_AUDIT_ACE_TYPE	Systemüberwachungs-ACE, die die SYSTEM_AUDIT_ACE Struktur verwendet.

AceFlags

Set of ACE type-specific control flags. Dieses Element kann eine Kombination aus den folgenden Werten sein:

Wert	Bedeutung
CONTAINER_INHERIT_ACE	Untergeordnete Objekte, die Container sind, z. B. Verzeichnisse, erben die ACE als effektive ACE. Die geerbte ACE ist vererbbar, es sei denn, das NO_PROPAGATE_INHERIT_ACE Bit-Flag ist ebenfalls festgelegt.
FAILED_ACCESS_ACE_FLAG	Wird mit Systemüberwachungs-ACEs in einer SACL verwendet, um Überwachungsmeldungen für fehlgeschlagene Zugriffsversuche zu generieren.
INHERIT_ONLY_ACE	Gibt eine erbgeschützte ACE an, die keinen Zugriff auf das Objekt steuert, an das es angefügt ist. Wenn dieses Flag nicht festgelegt ist, ist die ACE eine effektive ACE, die den Zugriff auf das Objekt steuert, an das es angefügt ist. Sowohl effektive als auch nur vererbte ACEs können abhängig vom Status der anderen Vererbungskennzeichnungen geerbt werden.
INHERITED_ACE	Microsoft Windows 2000 oder höher: Gibt an, dass die ACE geerbt wurde. Das System legt dieses Bit fest, wenn es eine geerbte ACE an ein untergeordnetes Objekt verteilt.
NO_PROPAGATE_INHERIT_ACE	Wenn die ACE von einem untergeordneten Objekt geerbt wird, löscht das System die OBJECT_INHERIT_ACE und CONTAINER_INHERIT_ACE Flags in der geerbten ACE. Dadurch wird verhindert, dass die ACE von nachfolgenden Generationen von Objekten geerbt wird.
OBJECT_INHERIT_ACE	Untergeordnete Nichtcontainerobjekte erben die ACE als effektive ACE. Bei untergeordneten Objekten, die Container sind, wird die ACE als nur erbgeschützte ACE geerbt, es sei denn, das NO_PROPAGATE_INHERIT_ACE Bit-Flag ist ebenfalls festgelegt.
SUCCESSFUL_ACCESS_ACE_FLAG	Wird mit Systemüberwachungs-ACEs in einer SACL verwendet, um Überwachungsmeldungen für erfolgreiche Zugriffsversuche zu generieren.

AceSize

Größe der ACE in Byte.

Bemerkungen

Die ACE_HEADER Struktur ist das erste Mitglied der verschiedenen Arten von ACE-Strukturen, z. B. ACCESS_ALLOWED_ACE.

Systemalarm-ACEs werden derzeit nicht unterstützt. Das AceType Member kann die SYSTEM_ALARM_ACE_TYPE nicht angeben. Verwenden Sie die SYSTEM_ALARM_ACE Struktur nicht.