structure OBJECTS_AND_NAME_A (accctrl.h)

Article
08/22/2023

La structure OBJECTS_AND_NAME contient une chaîne qui identifie un administrateur par son nom et des chaînes supplémentaires qui identifient les types d’objets d’une entrée de contrôle d’accès spécifique à un objet (ACE).

Syntaxe

typedef struct _OBJECTS_AND_NAME_A {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPSTR          ObjectTypeName;
  LPSTR          InheritedObjectTypeName;
  LPSTR          ptstrName;
} OBJECTS_AND_NAME_A, *POBJECTS_AND_NAME_A;

Membres

ObjectsPresent

Indique si les membres ObjectTypeName et InheritedObjectTypeName contiennent des chaînes. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
ACE_OBJECT_TYPE_PRESENT 0x1	Le membre ObjectTypeName contient une chaîne.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	Le membre InheritedObjectTypeName contient une chaîne.

ObjectType

Spécifie une valeur de l’énumération SE_OBJECT_TYPE qui indique le type d’objet.

ObjectTypeName

Pointeur vers une chaîne terminée par null qui identifie le type d’objet auquel l’ACE s’applique.

Cette chaîne doit être un nom d’affichage LDAP valide dans le schéma Active Directory.

InheritedObjectTypeName

Pointeur vers une chaîne terminée par null qui identifie le type d’objet qui peut hériter de l’ACE.

Cette chaîne doit être un nom d’affichage LDAP 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 InheritedObjectTypeName 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.

ptstrName

Pointeur vers une chaîne terminée par null qui contient le nom du fiduciaire.

Remarques

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

Notes

L’en-tête accctrl.h définit OBJECTS_AND_NAME_ comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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