ACE_HEADER-Struktur (winnt.h)
Die ACE_HEADER-Struktur definiert den Typ und die Größe eines Zugriffssteuerungseintrags (Access Control Entry , ACE).
Syntax
typedef struct _ACE_HEADER {
BYTE AceType;
BYTE AceFlags;
WORD AceSize;
} ACE_HEADER;
Member
AceType
Gibt den ACE-Typ an. Dieser Member kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Zugriffsberechtigungs-ACE, der die ACCESS_ALLOWED_ACE-Struktur verwendet. |
|
Zugriffsgeschützter Rückruf-ACE, der die ACCESS_ALLOWED_CALLBACK_ACE-Struktur verwendet. |
|
Objektspezifische Zugriffsberechtigungs-Rückruf-ACE, der die ACCESS_ALLOWED_CALLBACK_OBJECT_ACE-Struktur verwendet. |
|
Reserviert. |
|
Objektspezifische Zugriffsberechtigungs-ACE, die die ACCESS_ALLOWED_OBJECT_ACE-Struktur verwendet. |
|
Zugriffsverweigerungs-ACE, die die ACCESS_DENIED_ACE-Struktur verwendet. |
|
Zugriffsverweigerungs-Rückruf-ACE, der die ACCESS_DENIED_CALLBACK_ACE-Struktur verwendet. |
|
Objektspezifischer Zugriffsverweigerungs-Rückruf ACE, der die ACCESS_DENIED_CALLBACK_OBJECT_ACE-Struktur verwendet. |
|
Objektspezifische Zugriffsverweigerungs-ACE, die die ACCESS_DENIED_OBJECT_ACE-Struktur verwendet. |
|
Identisch mit SYSTEM_ALARM_OBJECT_ACE_TYPE. |
|
Identisch mit SYSTEM_ALARM_ACE_TYPE. |
|
Reserviert. |
|
Identisch mit SYSTEM_ALARM_OBJECT_ACE_TYPE. |
|
Identisch mit SYSTEM_ALARM_OBJECT_ACE_TYPE. |
|
Identisch mit ACCESS_ALLOWED_ACE_TYPE. |
|
Identisch mit ACCESS_ALLOWED_OBJECT_ACE_TYPE. |
|
Für die zukünftige Verwendung reserviert. Systemalarm-ACE, der die SYSTEM_ALARM_ACE-Struktur verwendet. |
|
Für die zukünftige Verwendung reserviert. Systemalarm-Rückruf-ACE, der die SYSTEM_ALARM_CALLBACK_ACE-Struktur verwendet. |
|
Für die zukünftige Verwendung reserviert. Objektspezifischer Systemalarm-Rückruf-ACE, der die SYSTEM_ALARM_CALLBACK_OBJECT_ACE-Struktur verwendet. |
|
Für die zukünftige Verwendung reserviert. Objektspezifischer Systemalarm-ACE, der die SYSTEM_ALARM_OBJECT_ACE-Struktur verwendet. |
|
Systemüberwachungs-ACE, der die SYSTEM_AUDIT_ACE-Struktur verwendet. |
|
Systemüberwachungs-Rückruf-ACE, der die SYSTEM_AUDIT_CALLBACK_ACE-Struktur verwendet. |
|
Objektspezifischer Systemüberwachungs-Rückruf-ACE, der die SYSTEM_AUDIT_CALLBACK_OBJECT_ACE-Struktur verwendet. |
|
Objektspezifischer Systemüberwachungs-ACE, der die SYSTEM_AUDIT_OBJECT_ACE-Struktur verwendet. |
|
Obligatorische Bezeichnungs-ACE, die die SYSTEM_MANDATORY_LABEL_ACE-Struktur verwendet. |
AceFlags
Gibt einen Satz von typspezifischen ACE-Steuerelementflags an. Dieser Member kann eine Kombination der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Untergeordnete Objekte, bei denen es sich um Container handelt, z. B. Verzeichnisse, erben den ACE als effektives ACE. Der geerbte ACE ist vererbbar, es sei denn, das NO_PROPAGATE_INHERIT_ACE Bitflag ist ebenfalls festgelegt. |
|
Wird mit Systemüberwachungs-ACEs in einer Systemzugriffssteuerungsliste (SACL) verwendet, um Überwachungsmeldungen für fehlgeschlagene Zugriffsversuche zu generieren. |
|
Gibt einen nur erbenden ACE an, der den Zugriff auf das Objekt, an das es angefügt ist, nicht steuert. Wenn dieses Flag nicht festgelegt ist, ist der ACE ein effektiver ACE, der den Zugriff auf das Objekt steuert, an das es angefügt ist.
Abhängig vom Status der anderen Vererbungsflags können sowohl effektive als auch nur vererbte ACEs geerbt werden. |
|
Gibt an, dass der ACE geerbt wurde. Das System legt dieses Bit fest, wenn ein geerbter ACE an ein untergeordnetes Objekt weitergegeben wird. |
|
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 Generationen von Objekten vererbt wird. |
|
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. |
|
Wird mit Systemüberwachungs-ACEs in einer SACL verwendet, um Überwachungsmeldungen für erfolgreiche Zugriffsversuche zu generieren. |
AceSize
Gibt die Größe des ACE in Bytes an.
Hinweise
Die ACE_HEADER-Struktur ist das erste Element der verschiedenen Arten von ACE-Strukturen, z. B. ACCESS_ALLOWED_ACE.
Systemalarm-ACEs werden derzeit nicht unterstützt. Der AceType-Member kann die SYSTEM_ALARM_ACE_TYPE- oder SYSTEM_ALARM_OBJECT_ACE_TYPE-Werte nicht angeben. Verwenden Sie nicht die SYSTEM_ALARM_ACE- oder SYSTEM_ALARM_OBJECT_ACE-Strukturen .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | winnt.h (Einschließen von Windows.h) |