FindFirstFreeAce 函数 (securitybaseapi.h)

FindFirstFreeAce 函数检索指向访问控制列表中的第一个自由字节的指针， (ACL) 。

语法

BOOL FindFirstFreeAce(
  [in]  PACL   pAcl,
  [out] LPVOID *pAce
);

[in] pAcl

指向 ACL 的指针。

[out] pAce

指向函数返回时创建的 ACL 中第一个可用位置的指针的地址。如果 ACL 无效，则此参数为 NULL。如果 ACL 已满，则此参数指向紧跟 ACL 的字节。

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

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

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