GetAce function (securitybaseapi.h)
The GetAce function obtains a pointer to an access control entry (ACE) in an access control list (ACL).
C++
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 |