ACE_HEADER-Struktur (ntifs.h)

Artikel
02/29/2024

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;

Member

AceType

ACE-Typ. Dieser Member kann einer der folgenden Werte sein:

Wert	Bedeutung
ACCESS_ALLOWED_ACE_TYPE	Zugriffsberechtigtes ACE, das die ACCESS_ALLOWED_ACE-Struktur verwendet.
ACCESS_DENIED_ACE_TYPE	Zugriffsverweigerungs-ACE, das die ACCESS_DENIED_ACE-Struktur verwendet.
SYSTEM_AUDIT_ACE_TYPE	Systemüberwachungs-ACE, der die SYSTEM_AUDIT_ACE-Struktur verwendet.

AceFlags

Satz von typspezifischen ACE-Steuerelementflags. Dieses Element kann eine Kombination der folgenden Werte sein:

Wert	Bedeutung
CONTAINER_INHERIT_ACE	Untergeordnete Objekte, die Container sind, z. B. Verzeichnisse, erben den ACE als effektives ACE. Das geerbte ACE ist vererbt, es sei denn, das NO_PROPAGATE_INHERIT_ACE Bitflag 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 einen erbgeschützten ACE an, der den Zugriff auf das Objekt, an das es angefügt ist, nicht steuert. Wenn dieses Flag nicht festgelegt ist, ist das ACE ein effektiver ACE, der den Zugriff auf das Objekt steuert, an das es angefügt ist. Sowohl effektive als auch nur vererbte ACEs können abhängig vom Zustand der anderen Vererbungsflags geerbt werden.
INHERITED_ACE	Microsoft Windows 2000 oder höher: Gibt an, dass der ACE geerbt wurde. Das System legt dieses Bit fest, wenn ein geerbter ACE an ein untergeordnetes Objekt weitergegeben wird.
NO_PROPAGATE_INHERIT_ACE	Wenn der ACE von einem untergeordneten Objekt geerbt wird, löscht das System die OBJECT_INHERIT_ACE und CONTAINER_INHERIT_ACE Flags im geerbten ACE. Dadurch wird verhindert, dass der ACE von nachfolgenden Objektgenerationen geerbt wird.
OBJECT_INHERIT_ACE	Untergeordnete Nichtcontainerobjekte erben den ACE als effektives ACE. Bei untergeordneten Objekten, bei denen es sich um Container handelt, wird der ACE als reines Erben-ACE geerbt, es sei denn, das NO_PROPAGATE_INHERIT_ACE Bitflag 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 des ACE in Bytes.

Hinweise

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

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