GetSecurityDescriptorSacl 函数 (securitybaseapi.h)

项目
03/01/2024

GetSecurityDescriptorSacl 函数检索指向指定安全描述符中 SACL) (系统访问控制列表的指针。

语法

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

参数

[in] pSecurityDescriptor

指向 SECURITY_DESCRIPTOR 结构的指针，该结构包含函数检索指针的 SACL。

[out] lpbSaclPresent

指向函数设置的标志的指针，指示指定安全描述符中是否存在 SACL。如果此参数为 TRUE，则安全描述符包含 SACL，并且此函数中的剩余输出参数接收有效值。如果此参数为 FALSE，则安全描述符不包含 SACL，并且剩余的输出参数不会接收有效值。

[out] pSacl

指向访问控制列表的指针 (ACL) 。如果 SACL 存在，则函数将 pSacl 指向的指针设置为安全描述符的 SACL 地址。如果 SACL 不存在，则不存储任何值。

如果函数在 pSacl 指向的指针中存储 NULL 值，则安全描述符具有 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