Function

SecAccessCopyMatchingACLList

Retrieves selected ACL entries from a given access instance.

Declaration

CFArrayRef SecAccessCopyMatchingACLList(SecAccessRef accessRef, CFTypeRef authorizationTag);

Parameters

accessRef

The access instance from which to retrieve the information.

authorizationTag

An access control list authorization tag. See ACL Authorization Keys for a list of possible values. The method returns only those ACL entries that apply to the operation indicated by this tag.

Return Value

An array containing the selected access control list entries. Call the CFRelease method to release the array when you are finished using it.

Discussion

An access instance can have any number of ACL entries for specific operations or sets of operations. This method returns the ACL entries that apply to the given operation. To retrieve all the ACL entries for an access instance, use the SecAccessCopyACLList method instead.

See Also

Access Query

SecAccessCopyACLList

Retrieves all the ACL entries of a given access instance.

SecAccessCopyOwnerAndACL

Retrieves the owner and the ACL entries of a given access instance.