GetSecurityDescriptorSacl 函数 (securitybaseapi.h)
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 不存在，则不会存储任何值。
如果函数将 NULL 值存储在 pSacl 指向的指针中，则安全描述符具有 NULL SACL。
[out] lpbSaclDefaulted
指向一个标志的指针，该标志设置为 SECURITY_DESCRIPTOR_CONTROL 结构中SE_SACL_DEFAULTED标志的值（如果存在安全描述符的 SACL）。
返回值
如果函数成功，该函数将返回非零。
如果函数失败，则返回零。 要获得更多的错误信息，请调用 GetLastError。
要求
| 最低受支持的客户端 | Windows XP [桌面应用|UWP 应用] |
| 最低受支持的服务器 | Windows Server 2003 [桌面应用|UWP 应用] |
| 目标平台 | Windows |
| 标头 | securitybaseapi.h (包括 Windows.h) |
| Library | Advapi32.lib |
| DLL | Advapi32.dll |