GetAce 函数 (securitybaseapi.h)

GetAce 函数获取一个指针,该指针指向访问控制列表中的访问控制项 (ACE) (ACL) 。

语法

BOOL GetAce(
  [in]  PACL   pAcl,
  [in]  DWORD  dwAceIndex,
  [out] LPVOID *pAce
);

parameters

[in] pAcl

指向包含要检索的 ACE 的 ACL 的指针。

[in] dwAceIndex

要检索的 ACE 的索引。 值零对应于 ACL 中的第一个 ACE,一个值对应于第二个 ACE,依此而论。

[out] pAce

指向函数设置为 ACE 地址的指针的指针。

返回值

如果函数成功,该函数将返回非零值。

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

要求

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

请参阅

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

低级别访问控制

低级别访问控制函数