структура ACE_HEADER (ntifs.h)

Структура ACE_HEADER описывает тип и размер записи управления доступом (ACE).

Синтаксис

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

Члены

AceType

Тип ACE. Этот элемент может иметь одно из следующих значений:

Значение Значение
ACCESS_ALLOWED_ACE_TYPE ACE с разрешенным доступом, использующим структуру ACCESS_ALLOWED_ACE.
ACCESS_DENIED_ACE_TYPE ACE с отказом в доступе, использующим структуру ACCESS_DENIED_ACE.
SYSTEM_AUDIT_ACE_TYPE ACE с системным аудитом, использующим структуру SYSTEM_AUDIT_ACE.

AceFlags

Набор флагов элементов управления, относящихся к типу ACE. Этот элемент может быть сочетанием следующих значений:

Значение Значение
CONTAINER_INHERIT_ACE Дочерние объекты, которые являются контейнерами, например каталоги, наследуют ACE как действующий ACE. Унаследованный ACE наследуется, если не установлен флаг бита NO_PROPAGATE_INHERIT_ACE.
FAILED_ACCESS_ACE_FLAG Используется с ACE для системного аудита в списке управления доступом для создания сообщений аудита для неудачных попыток доступа.
INHERIT_ONLY_ACE Указывает только наследуемый элемент управления доступом, который не управляет доступом к объекту, к которому он присоединен. Если этот флаг не задан, ACE является эффективным ACE, который управляет доступом к объекту, к которому он присоединен.

Как действующие, так и только наследуемые ACE могут наследоваться в зависимости от состояния других флагов наследования.

INHERITED_ACE Microsoft Windows 2000 или более поздней версии: Указывает, что ACE был унаследован. Система задает этот бит при распространении унаследованного ACE на дочерний объект.
NO_PROPAGATE_INHERIT_ACE Если ACE наследуется дочерним объектом, система очищает флаги OBJECT_INHERIT_ACE и CONTAINER_INHERIT_ACE в унаследованной ACE. Это предотвращает наследование ACE последующими поколениями объектов.
OBJECT_INHERIT_ACE Неконтейнерные дочерние объекты наследуют ACE как действующий ACE.

Для дочерних объектов, которые являются контейнерами, ACE наследуется как только наследуемый ACE, если не установлен флаг бита NO_PROPAGATE_INHERIT_ACE.

SUCCESSFUL_ACCESS_ACE_FLAG Используется с ACE системного аудита в списке управления доступом для создания сообщений аудита для успешных попыток доступа.

AceSize

Размер ACE в байтах.

Комментарии

Структура ACE_HEADER является первым элементом различных типов структур ACE, таких как ACCESS_ALLOWED_ACE.

ACE системной сигнализации в настоящее время не поддерживаются. Элемент AceType не может указать SYSTEM_ALARM_ACE_TYPE. Не используйте структуру SYSTEM_ALARM_ACE.

Требования

Требование Значение
Заголовок ntifs.h (включая Ntifs.h)

См. также раздел

ACCESS_ALLOWED_ACE

ACCESS_DENIED_ACE

ACE

ACL

SYSTEM_ALARM_ACE

SYSTEM_AUDIT_ACE