SetSecurityDescriptorSacl 함수(securitybaseapi.h)
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 |