SetSecurityDescriptorSacl 함수(securitybaseapi.h)

아티클
03/05/2024

SetSecurityDescriptorSacl 함수는 SACL(시스템 액세스 제어 목록)의 정보를 설정합니다. 보안 설명자에 SACL이 이미 있는 경우 대체됩니다.

구문

BOOL SetSecurityDescriptorSacl(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]           BOOL                 bSaclPresent,
  [in, optional] PACL                 pSacl,
  [in]           BOOL                 bSaclDefaulted
);

매개 변수

[in, out] pSecurityDescriptor

함수가 SACL을 추가하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 이 보안 설명자는 절대 형식이어야 합니다. 즉, 해당 멤버는 연속 데이터에 대한 오프셋이 아닌 다른 구조체에 대한 포인터여야 합니다.

[in] bSaclPresent

보안 설명자에 SACL이 있음을 나타냅니다. 이 매개 변수가 TRUE이면 함수는 SECURITY_DESCRIPTOR_CONTROL 구조에서 SE_SACL_PRESENT 플래그를 설정하고 pSacl 및 bSaclDefaulted 매개 변수의 값을 사용합니다. FALSE이면 함수가 SE_SACL_PRESENT 플래그를 설정하지 않고 pSacl 및 bSaclDefaulted가 무시됩니다.

[in, optional] pSacl

보안 설명자에 대한 SACL 을 지정하는 ACL 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 NULL SACL이 보안 설명자에 할당됩니다. SACL은 보안 설명자에 복사되지 않고 에서 참조됩니다.

[in] bSaclDefaulted

SACL의 원본을 나타냅니다. 이 플래그가 TRUE이면 SACL이 일부 기본 메커니즘에 의해 검색되었습니다. FALSE이면 SACL이 사용자가 명시적으로 지정했습니다. 함수는 이 값을 SECURITY_DESCRIPTOR_CONTROL 구조체 의 SE_SACL_DEFAULTED 플래그에 저장합니다. 이 매개 변수를 지정하지 않으면 SE_SACL_DEFAULTED 플래그가 지워집니다.

반환 값

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

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

요구 사항

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