estructura ACE_HEADER (ntifs.h)

2025-02-07

La estructura ACE_HEADER describe el tipo y el tamaño de una entrada de control de acceso (ACE).

Sintaxis

typedef struct _ACE_HEADER {
  UCHAR  AceType;
  UCHAR  AceFlags;
  USHORT AceSize;
} ACE_HEADER;

Miembros

AceType

Tipo ACE. Este miembro puede ser uno de los siguientes valores:

Valor	Significado
ACCESS_ALLOWED_ACE_TYPE	ACE permitida por el acceso que usa la estructura ACCESS_ALLOWED_ACE.
ACCESS_DENIED_ACE_TYPE	ACE denegada de acceso que usa la estructura ACCESS_DENIED_ACE.
SYSTEM_AUDIT_ACE_TYPE	ACE de auditoría del sistema que usa la estructura SYSTEM_AUDIT_ACE.

AceFlags

Conjunto de marcas de control específicas del tipo ACE. Este miembro puede ser una combinación de los siguientes valores:

Valor	Significado
CONTAINER_INHERIT_ACE	Los objetos secundarios que son contenedores, como directorios, heredan la ACE como una ACE efectiva. La ACE heredada se puede heredar a menos que también se establezca la marca de bits NO_PROPAGATE_INHERIT_ACE.
FAILED_ACCESS_ACE_FLAG	Se usa con las ACE de auditoría del sistema en una SACL para generar mensajes de auditoría para los intentos de acceso erróneos.
INHERIT_ONLY_ACE	Indica una ACE de solo herencia que no controla el acceso al objeto al que está asociado. Si no se establece esta marca, la ACE es una ACE efectiva que controla el acceso al objeto al que está asociado. Tanto los ACL efectivos como los de solo herencia se pueden heredar en función del estado de las otras marcas de herencia.
INHERITED_ACE	Microsoft Windows 2000 o posterior: Indica que se heredó la ACE. El sistema establece este bit cuando propaga una ACE heredada a un objeto secundario.
NO_PROPAGATE_INHERIT_ACE	Si un objeto secundario hereda la ACE, el sistema borra las marcas OBJECT_INHERIT_ACE y CONTAINER_INHERIT_ACE en la ACE heredada. Esto impide que la ACE se herede por generaciones posteriores de objetos.
OBJECT_INHERIT_ACE	Los objetos secundarios que no son de contenedor heredan la ACE como una ACE efectiva. En el caso de los objetos secundarios que son contenedores, la ACE se hereda como ace de solo herencia a menos que también se establezca la marca de bits de NO_PROPAGATE_INHERIT_ACE.
SUCCESSFUL_ACCESS_ACE_FLAG	Se usa con las ACE de auditoría del sistema en una SACL para generar mensajes de auditoría para los intentos de acceso correctos.

AceSize

Tamaño, en bytes, de la ACE.

Observaciones

La estructura ACE_HEADER es el primer miembro de los distintos tipos de estructuras ACE, como ACCESS_ALLOWED_ACE.

Actualmente no se admiten ACE de alarma del sistema. El miembro AceType no puede especificar el SYSTEM_ALARM_ACE_TYPE. No use la estructura SYSTEM_ALARM_ACE.