OBJECTS_AND_SID structure (accctrl.h)

Article
08/22/2023

La structure OBJECTS_AND_SID contient un identificateur de sécurité (SID) qui identifie un administrateur et des GUID qui identifient les types d’objets d’une entrée de contrôle d’accès (ACE) spécifique à l’objet .

Syntaxe

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

Membres

ObjectsPresent

Indique si les membres ObjectTypeGuid et InheritedObjectTypeGuid contiennent des GUID. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
ACE_OBJECT_TYPE_PRESENT 0x1	Le membre ObjectTypeGuid contient un GUID.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	Le membre InheritedObjectTypeGuid contient un GUID.

ObjectTypeGuid

Structure GUID qui identifie le type d’objet, de jeu de propriétés ou de propriété protégé par l’ACE. Si cette ACE est héritée, le GUID identifie le type d’objet, de jeu de propriétés ou de propriété protégé par l’ACE hérité. Ce GUID doit être un identificateur de schéma valide dans le schéma Active Directory.

Si le bit ACE_OBJECT_TYPE_PRESENT n’est pas défini dans le membre ObjectsPresent , le membre ObjectTypeGuid est ignoré et l’ACE protège l’objet auquel la liste de contrôle d’accès est affectée.

InheritedObjectTypeGuid

Structure GUID qui identifie le type d’objet qui peut hériter de l’ACE. Ce GUID doit être un identificateur de schéma valide dans le schéma Active Directory.

Si le bit ACE_INHERITED_OBJECT_TYPE_PRESENT n’est pas défini dans le membre ObjectsPresent , le membre InheritedObjectTypeGuid est ignoré et tous les types d’objets enfants peuvent hériter de l’ACE. Sinon, seul le type d’objet spécifié peut hériter de l’ACE. Dans les deux cas, l’héritage est également contrôlé par les indicateurs d’héritage dans la structure ACE_HEADER ainsi que par toute protection contre l’héritage placé sur les objets enfants.

pSid

Pointeur vers le SID du fiduciaire auquel l’ACE s’applique.

Remarques

Le membre ptstrName d’une structure TRUSTEE peut être un pointeur vers une structure OBJECTS_AND_SID . Cela permet à des fonctions telles que SetEntriesInAcl et GetExplicitEntriesFromAcl de stocker des informations ACE spécifiques à l’objet dans le membre Trustee d’une structure EXPLICIT_ACCESS .

Lorsque vous utilisez cette structure dans un appel à SetEntriesInAcl, ObjectTypeGuid et InheritedObjectTypeGuid doivent être des identificateurs de schéma valides dans le schéma Active Directory. Le système ne vérifie pas les GUID ; ils sont utilisés tels qu’ils sont.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	accctrl.h