structure ACE_HEADER (ntifs.h)
La structure ACE_HEADER décrit le type et la taille d’une entrée de contrôle d’accès (ACE).
Syntaxe
typedef struct _ACE_HEADER {
UCHAR AceType;
UCHAR AceFlags;
USHORT AceSize;
} ACE_HEADER;
Membres
AceType
Type ACE. Ce membre peut être l’une des valeurs suivantes :
| Valeur | Signification |
|---|---|
| ACCESS_ALLOWED_ACE_TYPE | ACE autorisé par accès qui utilise la structure ACCESS_ALLOWED_ACE. |
| ACCESS_DENIED_ACE_TYPE | Accès refusé ACE qui utilise la structure ACCESS_DENIED_ACE. |
| SYSTEM_AUDIT_ACE_TYPE | Ace d’audit système qui utilise la structure SYSTEM_AUDIT_ACE. |
AceFlags
Ensemble d’indicateurs de contrôle spécifiques au type ACE. Ce membre peut être une combinaison des valeurs suivantes :
| Valeur | Signification |
|---|---|
| CONTAINER_INHERIT_ACE | Les objets enfants qui sont des conteneurs, tels que des répertoires, héritent de l’ACE en tant qu’ACE efficace. L’ACE hérité est hérité, sauf si l’indicateur de bits NO_PROPAGATE_INHERIT_ACE est également défini. |
| FAILED_ACCESS_ACE_FLAG | Utilisé avec les ACL d’audit système dans une liste de contrôle d’accès pour générer des messages d’audit pour les tentatives d’accès ayant échoué. |
| INHERIT_ONLY_ACE |
Indique un ACE hérité uniquement qui ne contrôle pas l’accès à l’objet auquel il est attaché. Si cet indicateur n’est pas défini, l’ACE est un ace efficace qui contrôle l’accès à l’objet auquel il est attaché.
Les AE effectives et héritent uniquement peuvent être héritées en fonction de l’état des autres indicateurs d’héritage. |
| INHERITED_ACE | Microsoft Windows 2000 ou version ultérieure : indique que l’ACE a été hérité. Le système définit ce bit lorsqu’il propage un ACE hérité à un objet enfant. |
| NO_PROPAGATE_INHERIT_ACE | Si l’ACE est hérité par un objet enfant, le système efface les indicateurs OBJECT_INHERIT_ACE et CONTAINER_INHERIT_ACE dans l’ACE hérité. Cela empêche l’ACE d’être hérité par les générations suivantes d’objets. |
| OBJECT_INHERIT_ACE |
Les objets enfants noncontainer héritent de l’ACE en tant qu’ACE efficace.
Pour les objets enfants qui sont des conteneurs, l’ACE est hérité en tant qu’ACE hérite uniquement, sauf si l’indicateur de bits NO_PROPAGATE_INHERIT_ACE est également défini. |
| SUCCESSFUL_ACCESS_ACE_FLAG | Utilisé avec les ACL d’audit système dans une liste de contrôle d’accès pour générer des messages d’audit pour les tentatives d’accès réussies. |
AceSize
Taille, en octets, de l’ACE.
Remarques
La structure ACE_HEADER est le premier membre des différents types de structures ACE, comme ACCESS_ALLOWED_ACE.
Les aces d’alarme système ne sont actuellement pas prises en charge. Le membre AceType ne peut pas spécifier la SYSTEM_ALARM_ACE_TYPE. N’utilisez pas la structure SYSTEM_ALARM_ACE.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntifs.h (include Ntifs.h) |