structure OBJECTS_AND_NAME_A (accctrl.h)

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

Voir aussi

ACE_HEADER

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

OBJECTS_AND_SID

SE_OBJECT_TYPE

SetEntriesInAcl

FIDUCIAIRE