GetAce function (securitybaseapi.h)

The GetAce function obtains a pointer to an access control entry (ACE) in an access control list (ACL).

Syntax

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

[in] pAcl

A pointer to an ACL that contains the ACE to be retrieved.

[in] dwAceIndex

The index of the ACE to be retrieved. A value of zero corresponds to the first ACE in the ACL, a value of one to the second ACE, and so on.

[out] pAce

A pointer to a pointer that the function sets to the address of the ACE.

If the function succeeds, the function returns nonzero.

If the function fails, it returns zero. To get extended error information, call GetLastError.

Requirement	Value
Minimum supported client	Windows XP [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2003 [desktop apps \| UWP apps]
Target Platform	Windows
Header	securitybaseapi.h (include Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll