ACTRL_ACCESS_ENTRYA 구조체(accctrl.h)

  • 아티클

지정된 트러스티에 대한 액세스 제어 정보를 포함합니다. 이 구조체는 ACE에 저장된 액세스 제어 정보에 해당하는 정보를 저장합니다.

구문

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

멤버

Trustee

액세스 제어 항목이 적용되는 사용자, 그룹 또는 프로그램(예: 서비스)을 식별하는 TRUSTEE 구조입니다.

fAccessFlags

Access 및 ProvSpecificAccess 멤버가 지정한 액세스 권한이 트러스티에 적용되는 방식을 나타냅니다. 이 멤버는 다음 값 중 하나일 수 있습니다. IAccessControl의 COM 구현에서 이 구조를 사용하는 경우 이 멤버는 ACTRL_ACCESS_ALLOWED 또는 ACTRL_ACCESS_DENIED 합니다.

값 의미
ACTRL_ACCESS_ALLOWED
0x00000001
 권한이 허용됩니다.
ACTRL_ACCESS_DENIED
0x00000002
 권한이 거부됩니다.
ACTRL_AUDIT_SUCCESS
0x00000004
 시스템은 권한 사용 시도 실패에 대한 감사 메시지를 생성합니다.
ACTRL_AUDIT_FAILURE
0x00000008
 시스템은 권한 사용을 성공적으로 시도하기 위해 감사 메시지를 생성합니다.

Access

항목이 트러스티에 대해 허용, 거부 또는 감사하는 액세스 권한을 지정하는 비트 마스크입니다.

이 멤버는 READ_CONTROL 같은 액세스 플래그 대신 ACTRL_READ_CONTROL 같은 공급자 독립적 액세스 플래그를 사용해야 합니다. 개체 형식에 대한 공급자는 이러한 공급자 독립적 플래그를 해당 공급자별 플래그로 변환합니다.

IAccessControl의 COM 구현과 함께 이 구조를 사용하는 경우 이 멤버는 COM_RIGHTS_EXECUTE 합니다.

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

공급자 유형과 관련된 액세스 권한을 지정하는 비트 마스크입니다. ACTRL_ACCESS_ENTRY 구조를 사용하는 함수는 이러한 비트를 해석하지 않고 공급자에 전달합니다. 대부분의 경우 이 멤버는 0이어야 합니다.

Inheritance

다른 컨테이너 또는 개체가 액세스 목록이 연결된 기본 개체에서 액세스 제어 항목을 상속할 수 있는지 여부를 결정하는 비트 플래그 집합입니다. IAccessControl의 COM 구현과 함께 이 구조를 사용하는 경우 이 값은 액세스 제어 항목을 상속할 수 없음을 나타내는 NO_INHERITANCE 합니다. 그렇지 않으면 이 값이 NO_INHERITANCE 수 있거나 다음 값의 조합일 수 있습니다.

값 의미
CONTAINER_INHERIT_ACE
0x2
 기본 개체에 포함된 다른 컨테이너는 항목을 상속합니다.
INHERIT_ONLY_ACE
0x8
 ACE는 ACL이 연결된 기본 개체에는 적용되지 않지만 주 개체에 포함된 개체는 항목을 상속합니다.
NO_PROPAGATE_INHERIT_ACE
0x4
 OBJECT_INHERIT_ACE 및 CONTAINER_INHERIT_ACE 플래그는 상속된 항목으로 전파되지 않습니다.
OBJECT_INHERIT_ACE
0x1
 기본 개체에 포함된 비컨테이너 개체는 항목을 상속합니다.
SUB_CONTAINERS_AND_OBJECTS_INHERIT
0x3
 기본 개체에 포함된 컨테이너 및 비컨테이너 개체는 모두 항목을 상속합니다. 이 플래그는 CONTAINER_INHERIT_ACE 및 OBJECT_INHERIT_ACE 플래그의 조합에 해당합니다.
SUB_CONTAINERS_ONLY_INHERIT
0x2
 기본 개체에 포함된 다른 컨테이너는 항목을 상속합니다. 이 플래그는 CONTAINER_INHERIT_ACE 플래그에 해당합니다.
SUB_OBJECTS_ONLY_INHERIT
0x1
 기본 개체에 포함된 비컨테이너 개체는 항목을 상속합니다. 이 플래그는 OBJECT_INHERIT_ACE 플래그에 해당합니다.

lpInheritProperty

항목을 상속할 수 있는 개체 형식을 식별하는 null로 끝나는 문자열에 대한 포인터입니다. IAccessControl의 COM 구현과 함께 이 구조를 사용하는 경우 이 멤버는 NULL이어야 합니다.

설명

참고

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

요구 사항

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

추가 정보

ACTRL_ACCESS_ENTRY_LIST

트러스티