getSecurityDescriptorDacl 函数 (securitybaseapi.h)

项目
03/13/2024

GetSecurityDescriptorDacl 函数检索指向指定安全描述符中 (DACL) 自由访问控制列表的指针。

语法

BOOL GetSecurityDescriptorDacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbDaclPresent,
  [out] PACL                 *pDacl,
  [out] LPBOOL               lpbDaclDefaulted
);

参数

[in] pSecurityDescriptor

指向包含 DACL 的 SECURITY_DESCRIPTOR 结构的指针。函数检索指向它的指针。

[out] lpbDaclPresent

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

对于 lpbDaclPresent，值为 TRUE 并不意味着 pDacl 不为 NULL。也就是说，当 pDacl 为 NULL 时，lpbDaclPresent 可以为 TRUE，这意味着 NULL DACL 有效。 NULL DACL 隐式允许对对象的所有访问，与空 DACL 不同。空 DACL 不允许访问对象。有关创建正确 DACL 的信息，请参阅创建 DACL。

[out] pDacl

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

如果函数在 pDacl 指向的指针中存储 NULL 值，则安全描述符具有 NULL DACL。 NULL DACL 隐式允许对对象的所有访问。

如果应用程序需要非 NULL DACL，但遇到 NULL DACL，则应用程序应安全失败，不允许访问。

[out] lpbDaclDefaulted

指向一个标志的指针，该标志设置为SECURITY_DESCRIPTOR_CONTROL结构中 SE_DACL_DEFAULTED 标志的值（如果安全描述符存在 DACL）。如果此标志为 TRUE，则默认机制检索 DACL;如果 为 FALSE，则表示 DACL 由用户显式指定。

返回值

如果函数成功，则函数返回非零值。

如果函数失败，则返回零。要获得更多的错误信息，请调用 GetLastError。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	securitybaseapi.h (包括 Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll