estructura ACE_HEADER (winnt.h)

Artículo
03/08/2023

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

Sintaxis

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

Miembros

AceType

Especifica el 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_ALLOWED_CALLBACK_ACE_TYPE	ACE de devolución de llamada permitida por el acceso que usa la estructura ACCESS_ALLOWED_CALLBACK_ACE .
ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE	ACE de devolución de llamada permitida para el acceso específico del objeto que usa la estructura de ACCESS_ALLOWED_CALLBACK_OBJECT_ACE .
ACCESS_ALLOWED_COMPOUND_ACE_TYPE	Reservado.
ACCESS_ALLOWED_OBJECT_ACE_TYPE	ACE permitida para el acceso específico del objeto que usa la estructura ACCESS_ALLOWED_OBJECT_ACE .
ACCESS_DENIED_ACE_TYPE	ACE de acceso denegado que usa la estructura ACCESS_DENIED_ACE .
ACCESS_DENIED_CALLBACK_ACE_TYPE	ACE de devolución de llamada denegada de acceso que usa la estructura ACCESS_DENIED_CALLBACK_ACE .
ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE	ACE de devolución de llamada específica del objeto que usa la estructura de ACCESS_DENIED_CALLBACK_OBJECT_ACE .
ACCESS_DENIED_OBJECT_ACE_TYPE	ACE de acceso denegado específico del objeto que usa la estructura de ACCESS_DENIED_OBJECT_ACE .
ACCESS_MAX_MS_ACE_TYPE	Igual que SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_V2_ACE_TYPE	Igual que SYSTEM_ALARM_ACE_TYPE.
ACCESS_MAX_MS_V3_ACE_TYPE	Reservado.
ACCESS_MAX_MS_V4_ACE_TYPE	Igual que SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MAX_MS_OBJECT_ACE_TYPE	Igual que SYSTEM_ALARM_OBJECT_ACE_TYPE.
ACCESS_MIN_MS_ACE_TYPE	Igual que ACCESS_ALLOWED_ACE_TYPE.
ACCESS_MIN_MS_OBJECT_ACE_TYPE	Igual que ACCESS_ALLOWED_OBJECT_ACE_TYPE.
SYSTEM_ALARM_ACE_TYPE	Reservado para uso futuro. ACE de alarma del sistema que usa la estructura SYSTEM_ALARM_ACE .
SYSTEM_ALARM_CALLBACK_ACE_TYPE	Reservado para uso futuro. ACE de devolución de llamada de alarma del sistema que usa la estructura SYSTEM_ALARM_CALLBACK_ACE .
SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE	Reservado para uso futuro. ACE de devolución de llamada de alarma del sistema específica del objeto que usa la estructura SYSTEM_ALARM_CALLBACK_OBJECT_ACE .
SYSTEM_ALARM_OBJECT_ACE_TYPE	Reservado para uso futuro. ACE de alarma del sistema específica del objeto que usa la estructura SYSTEM_ALARM_OBJECT_ACE .
SYSTEM_AUDIT_ACE_TYPE	ACE de auditoría del sistema que usa la estructura SYSTEM_AUDIT_ACE .
SYSTEM_AUDIT_CALLBACK_ACE_TYPE	ACE de devolución de llamada de auditoría del sistema que usa la estructura de SYSTEM_AUDIT_CALLBACK_ACE .
SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE	ACE de devolución de llamada de auditoría del sistema específica del objeto que usa la estructura de SYSTEM_AUDIT_CALLBACK_OBJECT_ACE .
SYSTEM_AUDIT_OBJECT_ACE_TYPE	ACE de auditoría del sistema específica del objeto que usa la estructura SYSTEM_AUDIT_OBJECT_ACE .
SYSTEM_MANDATORY_LABEL_ACE_TYPE 0x11	ACE de etiqueta obligatoria que usa la estructura SYSTEM_MANDATORY_LABEL_ACE .

AceFlags

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

Valor	Significado
CONTAINER_INHERIT_ACE	Los objetos secundarios que son contenedores, como los directorios, heredan la ACE como una ACE eficaz. La ACE heredada se puede heredar a menos que también se establezca la marca de bits de NO_PROPAGATE_INHERIT_ACE.
FAILED_ACCESS_ACE_FLAG	Se usa con ASE de auditoría del sistema en una lista de control de acceso del sistema (SACL) para generar mensajes de auditoría para 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 eficaz que controla el acceso al objeto al que está asociado. Tanto las ACE efectivas como las de solo herencia se pueden heredar en función del estado de las otras marcas de herencia.
INHERITED_ACE	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 evita que la ACE se herede por generaciones posteriores de objetos.
OBJECT_INHERIT_ACE	Los objetos secundarios no contenidos heredan la ACE como una ACE eficaz. 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 ASE de auditoría del sistema en una SACL para generar mensajes de auditoría para intentos de acceso correctos.

AceSize

Especifica el tamaño, en bytes, de la ACE.

Comentarios

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 los valores de SYSTEM_ALARM_ACE_TYPE o SYSTEM_ALARM_OBJECT_ACE_TYPE. No use las estructuras de SYSTEM_ALARM_ACE ni SYSTEM_ALARM_OBJECT_ACE .

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	winnt.h (incluye Windows.h)