structure ACTRL_ACCESS_ENTRYA (accctrl.h)

Article
11/20/2024

Contient des informations de contrôle d’accès pour un administrateur 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 (par exemple, un service) auquel l’entrée de contrôle d’accès s’applique.

fAccessFlags

Indique comment les droits d’accès spécifiés par le Access et ProvSpecificAccess membres s’appliquent au fiduciaire. Ce membre peut être l’une des valeurs suivantes. Si vous utilisez cette structure avec l’implémentation COM de 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 ayant échoué d’utiliser les droits.
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 les indicateurs d’accès tels que READ_CONTROL. Le fournisseur pour le 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 de 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 les droits d’accès spécifiques au type de fournisseur. Les fonctions qui utilisent la structure ACTRL_ACCESS_ENTRY passent 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 de IAccessControl, cette valeur doit être NO_INHERITANCE, ce qui indique que l’entrée de contrôle d’accès n’est pas héritée. Sinon, cette valeur peut être NO_INHERITANCE ou elle peut être 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 la liste de contrôle d’accès 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 noncontainer contenus par l’objet principal héritent de l’entrée.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Les conteneurs et les objets noncontainer contenus par l’objet principal héritent de l’entrée. Cet indicateur correspond à la combinaison des indicateurs de CONTAINER_INHERIT_ACE et de 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 noncontainer 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 de IAccessControl, ce membre doit être NULL.

Remarques

Note

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

Voir aussi

ACTRL_ACCESS_ENTRY_LIST

FIDUCIAIRE

Partager via