ISecurityInformation::GetAccessRights 메서드(aclui.h)

아티클
03/05/2024

GetAccessRights 메서드는 보안 개체에 대해 제어할 수 있는 액세스 권한에 대한 정보를 요청합니다. 액세스 제어 편집기에서 이 메서드를 호출하여 속성 페이지를 초기화하는 데 사용되는 표시 문자열 및 기타 정보를 검색합니다. 자세한 내용은 액세스 권한 및 액세스 마스크를 참조하세요.

구문

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

매개 변수

[in] pguidObjectType

액세스 권한이 요청되는 개체의 형식을 식별하는 GUID 구조체에 대한 포인터입니다. 이 매개 변수가 NULL 이거나 GUID_NULL 대한 포인터인 경우 편집 중인 개체에 대한 액세스 권한을 반환합니다. 그렇지 않으면 GUID는 ISecurityInformation::GetInheritTypes 메서드에서 반환된 자식 개체 형식을 식별합니다. GUID는 개체별 ACE의 InheritedObjectType 멤버에 해당합니다.

[in] dwFlags

초기화되는 속성 페이지를 나타내는 비트 플래그 집합입니다. 기본 보안 페이지가 초기화되는 경우 이 값은 0입니다. 그렇지 않으면 다음 값의 조합입니다.

값	의미
SI_ADVANCED	Advanced Security 속성 시트가 초기화되고 있습니다.
SI_EDIT_AUDITS	고급 보안 속성 시트에는 Audit 속성 페이지가 포함되어 있습니다.
SI_EDIT_PROPERTIES	Advanced Security 속성 시트를 사용하면 개체의 속성 및 속성 집합에 적용되는 AES를 편집할 수 있습니다.

[out] ppAccess

SI_ACCESS 구조체 배열에 대한 포인터입니다. 배열에는 각 액세스 권한에 대해 하나의 항목이 포함되어야 합니다. 개체 자체에 적용되는 액세스 권한과 개체의 속성 집합 또는 속성에만 적용되는 개체별 액세스 권한을 지정할 수 있습니다.

[out] pcAccesses

ppAccess 배열의 항목 수를 나타내는 ULONG에 대한 포인터입니다.

[out] piDefaultAccess

기본 액세스 권한이 포함된 배열 항목의 인덱스(0부터 시작)를 나타내는 ULONG 에 대한 포인터입니다. 액세스 제어 편집기에서는 이 항목을 새 ACE의 초기 액세스 권한으로 사용합니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

설명

GetAccessRights 메서드는 속성 페이지가 초기화될 때마다 호출됩니다.

액세스 제어 편집기에서는 ppAccess에서 반환된 포인터를 해제하지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	aclui.h