GetAce function
Applies to: desktop apps only
The GetAce function obtains a pointer to an access control entry (ACE) in an access control list (ACL).
Syntax
BOOL WINAPI GetAce( __in PACL pAcl, __in DWORD dwAceIndex, __out LPVOID *pAce );
Parameters
- pAcl [in]
-
A pointer to an ACL that contains the ACE to be retrieved.
- dwAceIndex [in]
-
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.
- pAce [out]
-
A pointer to a pointer that the function sets to the address of the ACE.
Return value
If the function succeeds, the function returns nonzero.
If the function fails, it returns zero. To get extended error information, call GetLastError.
Examples
For an example that uses this function, see Starting an Interactive Client Process.
Requirements
|
Minimum supported client | Windows XP |
|---|---|
|
Minimum supported server | Windows Server 2003 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Low-level Access Control
- Low-level Access Control Functions
- AddAccessAllowedAce
- AddAccessDeniedAce
- AddAce
- AddAuditAccessAce
- GetAclInformation
- InitializeAcl
Send comments about this topic to Microsoft
Build date: 3/7/2012
