ACE_HEADER 구조체(winnt.h)

아티클
08/27/2023

ACE_HEADER 구조체는 ACE(액세스 제어 항목)의 형식과 크기를 정의합니다.

구문

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

멤버

AceType

ACE 형식을 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
ACCESS_ALLOWED_ACE_TYPE	ACCESS_ALLOWED_ACE 구조를 사용하는 액세스 허용 ACE입니다.
ACCESS_ALLOWED_CALLBACK_ACE_TYPE	ACCESS_ALLOWED_CALLBACK_ACE 구조를 사용하는 액세스 허용 콜백 ACE입니다.
ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE	ACCESS_ALLOWED_CALLBACK_OBJECT_ACE 구조를 사용하는 개체별 액세스 허용 콜백 ACE입니다.
ACCESS_ALLOWED_COMPOUND_ACE_TYPE	예약되어 있습니다.
ACCESS_ALLOWED_OBJECT_ACE_TYPE	ACCESS_ALLOWED_OBJECT_ACE 구조를 사용하는 개체별 액세스 허용 ACE입니다.
ACCESS_DENIED_ACE_TYPE	ACCESS_DENIED_ACE 구조를 사용하는 액세스 거부 ACE입니다.
ACCESS_DENIED_CALLBACK_ACE_TYPE	ACCESS_DENIED_CALLBACK_ACE 구조를 사용하는 액세스 거부 콜백 ACE입니다.
ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE	ACCESS_DENIED_CALLBACK_OBJECT_ACE 구조를 사용하는 개체별 액세스 거부 콜백 ACE입니다.
ACCESS_DENIED_OBJECT_ACE_TYPE	ACCESS_DENIED_OBJECT_ACE 구조를 사용하는 개체별 액세스 거부 ACE입니다.
ACCESS_MAX_MS_ACE_TYPE	SYSTEM_ALARM_OBJECT_ACE_TYPE 동일합니다.
ACCESS_MAX_MS_V2_ACE_TYPE	SYSTEM_ALARM_ACE_TYPE 동일합니다.
ACCESS_MAX_MS_V3_ACE_TYPE	예약되어 있습니다.
ACCESS_MAX_MS_V4_ACE_TYPE	SYSTEM_ALARM_OBJECT_ACE_TYPE 동일합니다.
ACCESS_MAX_MS_OBJECT_ACE_TYPE	SYSTEM_ALARM_OBJECT_ACE_TYPE 동일합니다.
ACCESS_MIN_MS_ACE_TYPE	ACCESS_ALLOWED_ACE_TYPE 동일합니다.
ACCESS_MIN_MS_OBJECT_ACE_TYPE	ACCESS_ALLOWED_OBJECT_ACE_TYPE 동일합니다.
SYSTEM_ALARM_ACE_TYPE	다음에 사용하도록 예약됩니다. SYSTEM_ALARM_ACE 구조를 사용하는 시스템 경보 ACE입니다.
SYSTEM_ALARM_CALLBACK_ACE_TYPE	다음에 사용하도록 예약됩니다. SYSTEM_ALARM_CALLBACK_ACE 구조를 사용하는 시스템 경보 콜백 ACE입니다.
SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE	다음에 사용하도록 예약됩니다. SYSTEM_ALARM_CALLBACK_OBJECT_ACE 구조를 사용하는 개체별 시스템 경보 콜백 ACE입니다.
SYSTEM_ALARM_OBJECT_ACE_TYPE	다음에 사용하도록 예약됩니다. SYSTEM_ALARM_OBJECT_ACE 구조를 사용하는 개체별 시스템 경보 ACE입니다.
SYSTEM_AUDIT_ACE_TYPE	SYSTEM_AUDIT_ACE 구조를 사용하는 시스템 감사 ACE입니다.
SYSTEM_AUDIT_CALLBACK_ACE_TYPE	SYSTEM_AUDIT_CALLBACK_ACE 구조를 사용하는 시스템 감사 콜백 ACE입니다.
SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE	SYSTEM_AUDIT_CALLBACK_OBJECT_ACE 구조를 사용하는 개체별 시스템 감사 콜백 ACE입니다.
SYSTEM_AUDIT_OBJECT_ACE_TYPE	SYSTEM_AUDIT_OBJECT_ACE 구조를 사용하는 개체별 시스템 감사 ACE입니다.
SYSTEM_MANDATORY_LABEL_ACE_TYPE 0x11	SYSTEM_MANDATORY_LABEL_ACE 구조를 사용하는 필수 레이블 ACE입니다.

AceFlags

ACE 형식별 컨트롤 플래그 집합을 지정합니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값	의미
CONTAINER_INHERIT_ACE	디렉터리 같은 컨테이너인 자식 개체는 ACE를 유효 ACE로 상속합니다. 상속된 ACE는 NO_PROPAGATE_INHERIT_ACE 비트 플래그도 설정되지 않는 한 상속할 수 있습니다.
FAILED_ACCESS_ACE_FLAG	SACL( 시스템 액세스 제어 목록 )의 시스템 감사 ACE와 함께 사용하여 실패한 액세스 시도에 대한 감사 메시지를 생성합니다.
INHERIT_ONLY_ACE	연결된 개체에 대한 액세스를 제어하지 않는 상속 전용 ACE를 나타냅니다. 이 플래그가 설정되지 않은 경우 ACE는 연결된 개체에 대한 액세스를 제어하는 유효 ACE입니다. 다른 상속 플래그의 상태에 따라 유효 및 상속 전용 ACE를 모두 상속할 수 있습니다.
INHERITED_ACE	ACE가 상속되었음을 나타냅니다. 시스템은 상속된 ACE를 자식 개체에 전파할 때 이 비트를 설정합니다.
NO_PROPAGATE_INHERIT_ACE	ACE가 자식 개체에 상속되는 경우 시스템은 상속된 ACE에서 OBJECT_INHERIT_ACE 지우고 플래그를 CONTAINER_INHERIT_ACE. 이렇게 하면 ACE가 후속 세대의 개체에 의해 상속되지 않습니다.
OBJECT_INHERIT_ACE	비컨테이너 자식 개체는 ACE를 유효 ACE로 상속합니다. 컨테이너인 자식 개체의 경우 NO_PROPAGATE_INHERIT_ACE 비트 플래그도 설정되지 않는 한 ACE는 상속 전용 ACE로 상속됩니다.
SUCCESSFUL_ACCESS_ACE_FLAG	SACL의 시스템 감사 ACE와 함께 사용하여 성공적인 액세스 시도에 대한 감사 메시지를 생성합니다.

AceSize

ACE의 크기(바이트)를 지정합니다.

설명

ACE_HEADER 구조체는 다양한 유형의 ACE 구조체(예: ACCESS_ALLOWED_ACE)의 첫 번째 멤버입니다.

시스템 경보 ACE는 현재 지원되지 않습니다. AceType 멤버는 SYSTEM_ALARM_ACE_TYPE 또는 SYSTEM_ALARM_OBJECT_ACE_TYPE 값을 지정할 수 없습니다. SYSTEM_ALARM_ACE 또는 SYSTEM_ALARM_OBJECT_ACE 구조를 사용하지 마세요.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	winnt.h(Windows.h 포함)