GetSecurityDescriptorSacl 함수(securitybaseapi.h)

아티클
08/25/2023

GetSecurityDescriptorSacl 함수는 지정된 보안 설명자의 SACL(시스템 액세스 제어 목록)에 대한 포인터를 검색합니다.

구문

BOOL GetSecurityDescriptorSacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbSaclPresent,
  [out] PACL                 *pSacl,
  [out] LPBOOL               lpbSaclDefaulted
);

매개 변수

[in] pSecurityDescriptor

함수가 포인터를 검색하는 SACL을 포함하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

[out] lpbSaclPresent

지정된 보안 설명자에 SACL이 있음을 나타내기 위해 함수가 설정하는 플래그에 대한 포인터입니다. 이 매개 변수가 TRUE이면 보안 설명자에 SACL이 포함되고 이 함수의 나머지 출력 매개 변수는 유효한 값을 받습니다. 이 매개 변수가 FALSE이면 보안 설명자에 SACL이 없으며 나머지 출력 매개 변수는 유효한 값을 받지 못합니다.

[out] pSacl

ACL( 액세스 제어 목록 )에 대한 포인터에 대한 포인터입니다. SACL이 있는 경우 함수는 pSacl 이 가리키는 포인터를 보안 설명자의 SACL 주소로 설정합니다. SACL이 없으면 값이 저장되지 않습니다.

함수가 pSacl이 가리키는 포인터에 NULL 값을 저장하는 경우 보안 설명자에는 NULL SACL이 있습니다.

[out] lpbSaclDefaulted

보안 설명자에 대한 SACL이 있는 경우 SECURITY_DESCRIPTOR_CONTROL 구조에서 SE_SACL_DEFAULTED 플래그 값으로 설정된 플래그에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 0이 아닌 값을 반환합니다.

함수가 실패하면 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	securitybaseapi.h(Windows.h 포함)
라이브러리	Advapi32.lib
DLL	Advapi32.dll