ISecurityInformation::GetSecurity 메서드(aclui.h)
GetSecurity 메서드는 보안 설명자가 편집되는 보안 개체에 대한 보안 설명자를 요청합니다. 액세스 제어 편집기는 이 메서드를 호출하여 개체의 현재 또는 기본 보안 설명자를 검색합니다.
구문
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
매개 변수
[in] RequestedInformation
요청되는 보안 설명자의 부분을 나타내는 SECURITY_INFORMATION 비트 플래그 집합입니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.
[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 |