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

另请参阅

GetAce

GetAclInformation

低级别访问控制

低级别访问控制函数