structure OBJECTS_AND_NAME_A (accctrl.h)

Article
11/20/2024

La structure OBJECTS_AND_NAME contient une chaîne qui identifie un administrateur par 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 complet 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 complet 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 ptstrName membre d’une structure TRUSTEE peut être un pointeur vers une structure OBJECTS_AND_NAME. Cela permet aux fonctions telles que SetEntriesInAcl et GetExplicitEntriesFromAcl de stocker des informations ACE spécifiques à l’objet dans le membre d’une structure de EXPLICIT_ACCESS.

Note

L’en-tête accctrl.h définit OBJECTS_AND_NAME_ en tant qu’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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	accctrl.h