Freigeben über


SYSTEM_ALARM_CALLBACK_OBJECT_ACE-Struktur (winnt.h)

Wird nicht unterstützt.

Die SYSTEM_ALARM_CALLBACK_OBJECT_ACE-Struktur ist für die zukünftige Verwendung reserviert.

Syntax

typedef struct _SYSTEM_ALARM_CALLBACK_OBJECT_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       Flags;
  GUID        ObjectType;
  GUID        InheritedObjectType;
  DWORD       SidStart;
} SYSTEM_ALARM_CALLBACK_OBJECT_ACE, *PSYSTEM_ALARM_CALLBACK_OBJECT_ACE;

Member

Header

ACE_HEADER Struktur, die die Größe und den Typ von ACE angibt. Es enthält Flags, die die Vererbung des ACE durch untergeordnete Objekte steuern. Die Struktur enthält auch Flags, die angeben, ob der ACE erfolgreiche Zugriffsversuche, fehlgeschlagene Zugriffsversuche oder beides überwacht. Das AceType-Element der ACE_HEADER-Struktur sollte auf SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE festgelegt werden.

Mask

Eine ACCESS_MASK , die die Zugriffsrechte angibt, die das System auf Zugriffsversuche durch den Treuhänder überwacht.

Flags

Ein Satz von Bitflags, die angeben, ob die Member ObjectType und InheritedObjectType GUIDs enthalten. Für diesen Parameter ist eine Kombination der folgenden Werte gültig. Legen Sie alle undefinierten Bits auf 0 (null) fest.

Wert Bedeutung
ACE_OBJECT_TYPE_PRESENT
Das ObjectType-Element enthält eine GUID.
ACE_INHERITED_OBJECT_TYPE_PRESENT
Das InheritedObjectType-Element enthält eine GUID.

ObjectType

Eine GUID-Struktur , die einen Eigenschaftensatz, eine Eigenschaft, eine erweiterte Rechte oder einen Typ untergeordneter Objekte identifiziert.

Dieser Member ist nur gültig, wenn das ACE_OBJECT_TYPE_PRESENT Bit im Flags-Element festgelegt ist. Andernfalls wird ObjectType ignoriert.

Der Zweck dieser GUID hängt von den im Mask-Element angegebenen Zugriffsrechten ab.

Wert Bedeutung
ADS_RIGHT_DS_READ_PROP und/oder ADS_RIGHT_DS_WRITE_PROP
Die ObjectType-GUID identifiziert einen Eigenschaftssatz oder eine Eigenschaft des Objekts. Der ACE steuert die Überwachung der Versuche des Treuhänders, die Eigenschaft oder den Eigenschaftensatz zu lesen oder zu schreiben.
ADS_RIGHT_DS_CONTROL_ACCESS
Die ObjectType-GUID identifiziert ein erweitertes Zugriffsrecht.
ADS_RIGHT_DS_CREATE_CHILD
Die ObjectType-GUID identifiziert einen Typ des untergeordneten Objekts. Der ACE steuert die Überwachung der Versuche des Treuhänders, diesen Typ von untergeordneten Objekten zu erstellen.
ADS_RIGHT_DS_SELF
Die ObjectType-GUID identifiziert einen überprüften Schreibvorgang.

InheritedObjectType

Eine GUID-Struktur , die den Typ des untergeordneten Objekts angibt, das den ACE erben kann.

Dieser Member ist nur gültig, wenn das ACE_INHERITED_OBJECT_TYPE_PRESENT Bit im Flags-Element festgelegt ist. Wenn dieses Bit nicht festgelegt ist, wird InheritedObjectType ignoriert, und alle Typen untergeordneter Objekte können den ACE erben. In beiden Fällen wird die Vererbung auch durch die Vererbungsflags im ACE_HEADER sowie durch jeglichen Schutz vor Vererbung für die untergeordneten Objekte gesteuert.

SidStart

Das erste DWORD des ACE eines Treuhänders. Dieser ACE kann mit Anwendungsdaten angefügt werden. Wenn die AuthzAccessCheckCallback-Funktion aufgerufen wird, wird diese ACE als pAce-Parameter dieser Funktion übergeben.

Hinweise

Wenn weder objectType noch InheritedObjectType GUID angegeben wird, weist die SYSTEM_ALARM_CALLBACK_OBJECT_ACE-Struktur dieselbe Semantik wie die SYSTEM_ALARM_CALLBACK_ACE-Struktur auf. Verwenden Sie in diesem Fall die SYSTEM_ALARM_CALLBACK_ACE-Struktur , da sie kleiner und effizienter ist.

Eine ACL, die eine SYSTEM_ALARM_CALLBACK_OBJECT_ACE enthält, muss die ACL_REVISION_DS Revisionsnummer in der ACE_HEADER-Struktur angeben.

Anforderungen

Anforderung Wert
Header winnt.h