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

아티클
02/26/2024

GetSecurity 메서드는 보안 설명자가 편집되는 보안 개체에 대한 보안 설명자를 요청합니다. 액세스 제어 편집기는 이 메서드를 호출하여 개체의 현재 또는 기본 보안 설명자를 검색합니다.

구문

HRESULT GetSecurity(
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [in]  BOOL                 fDefault
);

매개 변수

[in] RequestedInformation

요청되는 보안 설명자의 부분을 나타내는 SECURITY_INFORMATION 비트 플래그 집합입니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

값	의미
OWNER_SECURITY_INFORMATION	보안 설명자에는 개체 소유자의 SID가 포함되어야 합니다.
GROUP_SECURITY_INFORMATION	보안 설명자는 개체의 기본 그룹의 SID를 포함해야 합니다.
DACL_SECURITY_INFORMATION	보안 설명자에는 개체의 DACL이 포함되어야 합니다.
SACL_SECURITY_INFORMATION	보안 설명자에는 개체의 SACL이 포함되어야 합니다.

[out] ppSecurityDescriptor

구현이 개체의 보안 설명자에 대한 포인터로 설정해야 하는 변수에 대한 포인터입니다. 보안 설명자는 RequestedInformation 매개 변수에서 요청한 구성 요소를 포함해야 합니다.

시스템은 LocalFree 함수를 호출하여 반환된 포인터를 해제합니다.

[in] fDefault

이 매개 변수가 TRUE이면 ppSecurityDescriptor 는 개체에 대해 애플리케이션 정의 기본 보안 설명자를 반환해야 합니다. 액세스 제어 편집기는 이 기본 보안 설명자를 사용하여 속성 페이지를 다시 초기화합니다.

액세스 제어 편집기는 사용자가 기본 단추를 클릭하는 경우에만 이 매개 변수를 TRUE로 설정합니다. 기본 단추는 ISecurityInformation::GetObjectInformation 메서드에서 SI_RESET 플래그를 설정한 경우에만 표시됩니다. 사용할 수 있는 기본 보안 설명자가 없는 경우 SI_RESET 플래그를 설정하지 마세요.

이 플래그가 FALSE이면 ppSecurityDescriptor 는 개체의 현재 보안 설명자를 반환해야 합니다.

반환 값

성공하면 S_OK 반환합니다.

오류가 발생하면 0이 아닌 오류 코드를 반환합니다. 사용자에게 요청된 보안 정보를 읽을 수 있는 권한이 없는 경우 E_ACCESSDENIED 반환합니다.

요구 사항

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