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