OBJECTS_AND_SID-Struktur (accctrl.h)

Artikel
08/22/2023

Die OBJECTS_AND_SID-Struktur enthält einen Sicherheitsbezeichner (SID), der einen Trustee und GUIDs identifiziert, die die Objekttypen eines objektspezifischen Zugriffssteuerungseintrags (ACE) identifizieren.

Syntax

typedef struct _OBJECTS_AND_SID {
  DWORD ObjectsPresent;
  GUID  ObjectTypeGuid;
  GUID  InheritedObjectTypeGuid;
  SID   *pSid;
} OBJECTS_AND_SID, *POBJECTS_AND_SID;

Member

ObjectsPresent

Gibt an, ob die Member ObjectTypeGuid und InheritedObjectTypeGuid GUIDs enthalten. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
ACE_OBJECT_TYPE_PRESENT 0x1	Das ObjectTypeGuid-Element enthält eine GUID.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	Das InheritedObjectTypeGuid-Element enthält eine GUID.

ObjectTypeGuid

Eine GUID-Struktur , die den Typ des durch ace geschützten Objekts, Eigenschaftssatzes oder Eigenschaftssatzes identifiziert. Wenn dieser ACE geerbt wird, identifiziert die GUID den Typ des Objekts, des Eigenschaftensatzes oder der Eigenschaft, die durch den geerbten ACE geschützt ist. Diese GUID muss ein gültiger Schemabezeichner im Active Directory-Schema sein.

Wenn das ACE_OBJECT_TYPE_PRESENT Bit im ObjectsPresent-Member nicht festgelegt ist, wird das ObjectTypeGuid-Element ignoriert, und der ACE schützt das Objekt, dem die ACL zugewiesen ist.

InheritedObjectTypeGuid

Eine GUID-Struktur , die den Typ des Objekts identifiziert, das das ACE erben kann. Diese GUID muss ein gültiger Schemabezeichner im Active Directory-Schema sein.

Wenn das ACE_INHERITED_OBJECT_TYPE_PRESENT Bit im ObjectsPresent-Member nicht festgelegt ist, wird das InheritedObjectTypeGuid-Element ignoriert, und alle Typen von untergeordneten Objekten können den ACE erben. Andernfalls kann nur der angegebene Objekttyp den ACE erben. In beiden Fällen wird die Vererbung auch durch die Vererbungsflags in der ACE_HEADER-Struktur sowie durch jeglichen Schutz vor Vererbung an den untergeordneten Objekten gesteuert.

pSid

Ein Zeiger auf die SID des Treuhänders, für den der ACE gilt.

Hinweise

Das ptstrName-Element einer TRUSTEE-Struktur kann ein Zeiger auf eine OBJECTS_AND_SID-Struktur sein. Dadurch können Funktionen wie SetEntriesInAcl und GetExplicitEntriesFromAcl objektspezifische ACE-Informationen im Trustee-Member einer EXPLICIT_ACCESS-Struktur speichern.

Wenn Sie diese Struktur in einem Aufruf von SetEntriesInAcl verwenden, müssen ObjectTypeGuid und InheritedObjectTypeGuid gültige Schemabezeichner im Active Directory-Schema sein. Das System überprüft die GUIDs nicht. sie werden unverändert verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	accctrl.h