CAcl::GetAclEntry

Retrieves all of the information about an entry in an access-control list (ACL).

void GetAclEntry( 
   UINT nIndex, 
   CSid * pSid, 
   ACCESS_MASK * pMask = NULL, 
   BYTE * pType = NULL, 
   BYTE * pFlags = NULL, 
   GUID * pObjectType = NULL, 
   GUID * pInheritedObjectType = NULL 
) const throw(...);

Parameters

• nIndex
  Index to the ACL entry to retrieve.

• pSid
  The CSid object to which the ACL entry applies.

• pMask
  The mask specifying permissions to grant or deny access.

• pType
  The ACE type.

• pFlags
  The ACE flags.

• pObjectType
  The object type. This will be set to GUID_NULL if the object type is not specified in the ACE, or if the ACE is not an OBJECT ACE.

• pInheritedObjectType
  The inherited object type. This will be set to GUID_NULL if the inherited object type is not specified in the ACE, or if the ACE is not an OBJECT ACE.

Remarks

This method will retrieve all of the information about an individual ACE, providing more information than CAcl::GetAclEntries alone makes available.

See ACE_HEADER for more details on ACE types and flags.

Requirements

Header: atlsecurity.h

See Also

Reference

CAcl Class

CAcl::CAceFlagArray

CAcl::CAceTypeArray

ACCESS_MASK

CAcl::GetAclEntries

Other Resources

CAcl Members