EXPLICIT_ACCESS_A 구조체(accctrl.h)

아티클
08/22/2023

EXPLICIT_ACCESS 구조는 지정된 수탁자의 액세스 제어 정보를 정의합니다. SetEntriesInAcl 및 GetExplicitEntriesFromAcl과 같은 액세스 제어 함수는 이 구조를 사용하여 ACL(액세스 제어 목록)의 ACE(액세스 제어 항목)에 있는 정보를 설명합니다.

구문

typedef struct _EXPLICIT_ACCESS_A {
  DWORD       grfAccessPermissions;
  ACCESS_MODE grfAccessMode;
  DWORD       grfInheritance;
  TRUSTEE_A   Trustee;
} EXPLICIT_ACCESS_A, *PEXPLICIT_ACCESS_A, EXPLICIT_ACCESSA, *PEXPLICIT_ACCESSA;

멤버

grfAccessPermissions

ACCESS_MASK 형식을 사용하여 ACE가 트러스티에 대해 허용, 거부 또는 감사하는 액세스 권한을 지정하는 비트 플래그 집합입니다. EXPLICIT_ACCESS 구조를 사용하는 함수는 이 마스크의 비트를 변환, 해석 또는 유효성을 검사하지 않습니다.

grfAccessMode

ACCESS_MODE 열거형의 값입니다. DACL( 임의 액세스 제어 목록 )의 경우 이 플래그는 ACL이 지정된 액세스 권한을 허용하거나 거부하는지 여부를 나타냅니다. SACL( 시스템 액세스 제어 목록 )의 경우 이 플래그는 ACL이 지정된 액세스 권한을 성공적으로 사용하기 위해 감사 메시지를 생성하는지 또는 실패한 시도 또는 둘 다를 생성하는지 여부를 나타냅니다. 기존 ACL을 수정할 때 REVOKE_ACCESS 플래그를 지정하여 지정된 트러스티에 대한 기존 AES를 제거할 수 있습니다.

grfInheritance

다른 컨테이너 또는 개체가 ACL이 연결된 기본 개체에서 ACE를 상속할 수 있는지 여부를 결정하는 비트 플래그 집합입니다. 이 멤버의 값은 ACE_HEADER 구조체의 AceFlags 멤버의 상속 부분(하위 바이트)에 해당합니다. 이 매개 변수는 ACE를 상속할 수 없음을 나타내기 위해 NO_INHERITANCE 수 있습니다. 또는 다음 값의 조합일 수 있습니다.

값	의미
CONTAINER_INHERIT_ACE	주 개체에 포함된 다른 컨테이너는 ACE를 상속합니다.
INHERIT_NO_PROPAGATE	상속하지만 전파하지 않습니다.
INHERIT_ONLY	만 상속 합니다.
INHERIT_ONLY_ACE	ACE는 ACL이 연결된 기본 개체에는 적용되지 않지만 주 개체에 포함된 개체는 ACE를 상속합니다.
NO_INHERITANCE	상속하지 마세요.
NO_PROPAGATE_INHERIT_ACE	OBJECT_INHERIT_ACE 및 CONTAINER_INHERIT_ACE 플래그는 상속된 ACE로 전파되지 않습니다.
OBJECT_INHERIT_ACE	주 개체에 포함된 비컨테이너 개체는 ACE를 상속합니다.
SUB_CONTAINERS_AND_OBJECTS_INHERIT	기본 개체에 포함된 컨테이너 및 비컨테이너 개체는 모두 ACE를 상속합니다. 이 플래그는 CONTAINER_INHERIT_ACE 및 OBJECT_INHERIT_ACE 플래그의 조합에 해당합니다.
SUB_CONTAINERS_ONLY_INHERIT	주 개체에 포함된 다른 컨테이너는 ACE를 상속합니다. 이 플래그는 CONTAINER_INHERIT_ACE 플래그에 해당합니다.
SUB_OBJECTS_ONLY_INHERIT	주 개체에 포함된 비컨테이너 개체는 ACE를 상속합니다. 이 플래그는 OBJECT_INHERIT_ACE 플래그에 해당합니다.

Trustee

ACE가 적용되는 사용자, 그룹 또는 프로그램(예: Windows 서비스)을 식별하는 TRUSTEE 구조입니다.

설명

참고

accctrl.h 헤더는 EXPLICIT_ACCESS_ 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	accctrl.h