getAclInformation 函数 (securitybaseapi.h)

项目
03/01/2024

GetAclInformation 函数 (ACL) 检索有关访问控制列表的信息。

语法

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

参数

[in] pAcl

指向 ACL 的指针。函数检索有关此 ACL 的信息。如果传递了 null 值，则该函数会导致访问冲突。

[out] pAclInformation

指向用于接收所请求信息的缓冲区的指针。放置在缓冲区中的结构取决于 dwAclInformationClass 参数中请求的信息类。

[in] nAclInformationLength

pAclInformation 参数指向的缓冲区的大小（以字节为单位）。

[in] dwAclInformationClass

指示所请求信息的类的 ACL_INFORMATION_CLASS 枚举的值。此参数可以是此枚举中的两个值之一：

如果值为 AclRevisionInformation，则函数使用 ACL_REVISION_INFORMATION 结构填充 pAclInformation 参数指向的缓冲区。
如果值为 AclSizeInformation，则函数使用 ACL_SIZE_INFORMATION 结构填充 pAclInformation 参数指向的缓冲区。

返回值

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

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

要求

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