Поделиться через


структура 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 Используется с acES системного аудита в SACL для создания сообщений аудита для неудачных попыток доступа.
INHERIT_ONLY_ACE Указывает только наследуемый ACE, который не управляет доступом к объекту, к которому он подключен. Если этот флаг не задан, ACE является эффективным ACE, который управляет доступом к объекту, к которому он подключен.

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

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 Используется с acES системного аудита в SACL для создания сообщений аудита для успешных попыток доступа.

AceSize

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

Замечания

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

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

Требования

Требование Ценность
заголовка ntifs.h (include Ntifs.h)

См. также

ACCESS_ALLOWED_ACE

ACCESS_DENIED_ACE

ACE

ACL

SYSTEM_ALARM_ACE

SYSTEM_AUDIT_ACE