structure ACTRL_ACCESS_ENTRYA (accctrl.h)

Article
08/22/2023

Contient des informations de contrôle d’accès pour un fiduciaire spécifié. Cette structure stocke des informations équivalentes aux informations de contrôle d’accès stockées dans un ACE.

Syntaxe

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

Membres

Trustee

Structure TRUSTEE qui identifie l’utilisateur, le groupe ou le programme (tel qu’un service) auquel s’applique l’entrée de contrôle d’accès.

fAccessFlags

Indique comment les droits d’accès spécifiés par les membres Access et ProvSpecificAccess s’appliquent au fiduciaire. Ce membre peut être l’une des valeurs suivantes. Si vous utilisez cette structure avec l’implémentation COM d’IAccessControl, ce membre doit être ACTRL_ACCESS_ALLOWED ou ACTRL_ACCESS_DENIED.

Valeur	Signification
ACTRL_ACCESS_ALLOWED 0x00000001	Les droits sont autorisés.
ACTRL_ACCESS_DENIED 0x00000002	Les droits sont refusés.
ACTRL_AUDIT_SUCCESS 0x00000004	Le système génère des messages d’audit pour les tentatives d’utilisation des droits ayant échoué.
ACTRL_AUDIT_FAILURE 0x00000008	Le système génère des messages d’audit pour les tentatives réussies d’utilisation des droits.

Access

Masque de bits qui spécifie les droits d’accès que l’entrée autorise, refuse ou audite pour le fiduciaire.

Ce membre doit utiliser les indicateurs d’accès indépendants du fournisseur, tels que ACTRL_READ_CONTROL, plutôt que des indicateurs d’accès tels que READ_CONTROL. Le fournisseur du type d’objet convertit ces indicateurs indépendants du fournisseur en indicateurs spécifiques au fournisseur correspondants.

Si vous utilisez cette structure avec l’implémentation COM d’IAccessControl, ce membre doit être COM_RIGHTS_EXECUTE.

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

Masque de bits qui spécifie des droits d’accès spécifiques au type de fournisseur. Les fonctions qui utilisent la structure ACTRL_ACCESS_ENTRY transmettent ces bits au fournisseur sans les interpréter. Dans la plupart des cas, ce membre doit être 0.

Inheritance

Ensemble d’indicateurs de bits qui détermine si d’autres conteneurs ou objets peuvent hériter de l’entrée de contrôle d’accès de l’objet principal auquel la liste d’accès est attachée. Si vous utilisez cette structure avec l’implémentation COM d’IAccessControl, cette valeur doit être NO_INHERITANCE, ce qui indique que l’entrée de contrôle d’accès n’est pas héritable. Sinon, cette valeur peut être NO_INHERITANCE ou il peut s’agir d’une combinaison des valeurs suivantes.

Valeur	Signification
CONTAINER_INHERIT_ACE 0x2	Les autres conteneurs contenus par l’objet principal héritent de l’entrée.
INHERIT_ONLY_ACE 0x8	L’ACE ne s’applique pas à l’objet principal auquel l’ACL est attachée, mais les objets contenus par l’objet principal héritent de l’entrée.
NO_PROPAGATE_INHERIT_ACE 0x4	Les indicateurs OBJECT_INHERIT_ACE et CONTAINER_INHERIT_ACE ne sont pas propagés à une entrée héritée.
OBJECT_INHERIT_ACE 0x1	Les objets non-contenus contenus par l’objet principal héritent de l’entrée.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Les conteneurs et les objets non-contenants qui sont contenus par l’objet principal héritent de l’entrée. Cet indicateur correspond à la combinaison des indicateurs CONTAINER_INHERIT_ACE et OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT 0x2	Les autres conteneurs contenus par l’objet principal héritent de l’entrée. Cet indicateur correspond à l’indicateur CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT 0x1	Les objets non-contenus contenus par l’objet principal héritent de l’entrée. Cet indicateur correspond à l’indicateur OBJECT_INHERIT_ACE.

lpInheritProperty

Pointeur vers une chaîne terminée par null qui identifie les types d’objets qui peuvent hériter de l’entrée. Si vous utilisez cette structure avec l’implémentation COM d’IAccessControl, ce membre doit avoir la valeur NULL.

Remarques

Notes

L’en-tête accctrl.h définit ACTRL_ACCESS_ENTRY 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 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	accctrl.h

Voir aussi

ACTRL_ACCESS_ENTRY_LIST

FIDUCIAIRE

Partager via