ACE_HEADER structure (winnt.h)

Article
03/08/2023

La structure ACE_HEADER définit le type et la taille d’une entrée de contrôle d’accès (ACE).

Syntaxe

typedef struct _ACE_HEADER {
  BYTE AceType;
  BYTE AceFlags;
  WORD AceSize;
} ACE_HEADER;

Membres

AceType

Spécifie le 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_ALLOWED_CALLBACK_ACE_TYPE	ACE de rappel autorisé qui utilise la structure ACCESS_ALLOWED_CALLBACK_ACE .
ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE	Ace de rappel autorisé par accès spécifique à l’objet qui utilise la structure ACCESS_ALLOWED_CALLBACK_OBJECT_ACE .
ACCESS_ALLOWED_COMPOUND_ACE_TYPE	Réservé.
ACCESS_ALLOWED_OBJECT_ACE_TYPE	ACE autorisé par accès spécifique à l’objet qui utilise la structure ACCESS_ALLOWED_OBJECT_ACE .
ACCESS_DENIED_ACE_TYPE	ACE avec accès refusé qui utilise la structure ACCESS_DENIED_ACE .
ACCESS_DENIED_CALLBACK_ACE_TYPE	ACE de rappel refusé qui utilise la structure ACCESS_DENIED_CALLBACK_ACE .
ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE	ACE de rappel d’accès refusé spécifique à l’objet qui utilise la structure ACCESS_DENIED_CALLBACK_OBJECT_ACE .
ACCESS_DENIED_OBJECT_ACE_TYPE	ACE d’accès refusé spécifique à l’objet qui utilise la structure ACCESS_DENIED_OBJECT_ACE .
ACCESS_MAX_MS_ACE_TYPE	Identique à SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_V2_ACE_TYPE	Identique à SYSTEM_ALARM_ACE_TYPE.
ACCESS_MAX_MS_V3_ACE_TYPE	Réservé.
ACCESS_MAX_MS_V4_ACE_TYPE	Identique à SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_OBJECT_ACE_TYPE	Identique à SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MIN_MS_ACE_TYPE	Identique à ACCESS_ALLOWED_ACE_TYPE.
ACCESS_MIN_MS_OBJECT_ACE_TYPE	Identique à ACCESS_ALLOWED_OBJECT_ACE_TYPE.
SYSTEM_ALARM_ACE_TYPE	Réservé pour un usage futur. ACE d’alarme système qui utilise la structure SYSTEM_ALARM_ACE .
SYSTEM_ALARM_CALLBACK_ACE_TYPE	Réservé pour un usage futur. Ace de rappel d’alarme système qui utilise la structure SYSTEM_ALARM_CALLBACK_ACE .
SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE	Réservé pour un usage futur. Ace de rappel d’alarme système spécifique à l’objet qui utilise la structure SYSTEM_ALARM_CALLBACK_OBJECT_ACE .
SYSTEM_ALARM_OBJECT_ACE_TYPE	Réservé pour un usage futur. ACE d’alarme système spécifique à l’objet qui utilise la structure SYSTEM_ALARM_OBJECT_ACE .
SYSTEM_AUDIT_ACE_TYPE	ACE d’audit du système qui utilise la structure SYSTEM_AUDIT_ACE .
SYSTEM_AUDIT_CALLBACK_ACE_TYPE	Ace de rappel d’audit système qui utilise la structure SYSTEM_AUDIT_CALLBACK_ACE .
SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE	Ace de rappel d’audit système spécifique à l’objet qui utilise la structure SYSTEM_AUDIT_CALLBACK_OBJECT_ACE .
SYSTEM_AUDIT_OBJECT_ACE_TYPE	Ace d’audit système spécifique à l’objet qui utilise la structure SYSTEM_AUDIT_OBJECT_ACE .
SYSTEM_MANDATORY_LABEL_ACE_TYPE 0x11	Étiquette ACE obligatoire qui utilise la structure SYSTEM_MANDATORY_LABEL_ACE .

AceFlags

Spécifie un 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 que ACE efficace. L’ACE héritée peut être héritée, sauf si l’indicateur de bits NO_PROPAGATE_INHERIT_ACE est également défini.
FAILED_ACCESS_ACE_FLAG	Utilisé avec les AIC d’audit système dans une liste de contrôle d’accès système (SACL) 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 ACL effectifs et hérités uniquement peuvent être hérités en fonction de l’état des autres indicateurs d’héritage.
INHERITED_ACE	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 non-conteneur héritent de l’ACE en tant que ACE efficace. Pour les objets enfants qui sont des conteneurs, l’ACE est hérité en tant qu’ACE hérité uniquement, sauf si l’indicateur de bits NO_PROPAGATE_INHERIT_ACE est également défini.
SUCCESSFUL_ACCESS_ACE_FLAG	Utilisé avec les AIC d’audit système dans une liste SACL pour générer des messages d’audit pour les tentatives d’accès réussies.

AceSize

Spécifie la 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 ACL d’alarme système ne sont actuellement pas pris en charge. Le membre AceType ne peut pas spécifier les valeurs SYSTEM_ALARM_ACE_TYPE ou SYSTEM_ALARM_OBJECT_ACE_TYPE. N’utilisez pas les structures SYSTEM_ALARM_ACE ou SYSTEM_ALARM_OBJECT_ACE .

Configuration requise


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	winnt.h (inclure Windows.h)