| BOOL GetAce(Acl, AceIndex, Ace) | |||
| PACL Acl; | |||
| DWORD AceIndex; | |||
| LPVOID *Ace; |
The GetAce function obtains a pointer to an ACE stored in an ACL. An ACE is an access control entry. An ACL is an access control list.
The caller specifies the ACL and an index value that indicates the desired ACE.
Acl
Pointer to an existing ACL data structure that contains the ACE of interest.
The ACL data structure has the following form:
typedef struct _ACL { /* acl */
BYTE AclRevision;
BYTE Sbz1;
WORD AclSize;
WORD AceCount;
WORD Sbz2;
} ACL;
AceIndex
An zero-based index that specifies the ACE of interest. An ACL maintains a list of ACEs. A value of 0 corresponds to the ACL's first ACE, 1 to its second ACE, and so on.
Ace
Pointer to a variable that the function will set to the address of the ACE.
If the function is successful, the return value is TRUE.
If the function fails, the return value is FALSE. Call GetLastError for more detailed error information.
AddAccessAllowedAce, AddAce, DeleteAce, GetAclInformation, InitializeAcl, IsValidAcl, SetAclInformation