Describes an access right or level.

This interface provides helper methods that you can use to retrieve descriptive information for a particular access right or access level (a commonly-used combination of access rights) for a particular object. The most typical use of this interface's methods is to populate a security edit dialog. For example, you can retrieve a PermissionDescriptionList for an object, then use these methods to list the access rights and levels that a user can add. You can also retrieve the display name, descriptive text, and the permission type for the object.

The user must have Read (AccessRight.READ) permission on the parent object to be able to retrieve the permission description information.

You can get an instance of this object in the following ways:

  • By iterating an AccessPermissionDescriptionList collection.
  • By retrieving the TemplatePermissionDescriptions property from a SecurityTemplate object.
  • By retrieving the PermissionDescriptions property from a ClassDescription object.

These methods return an AccessPermissionDescriptionList collection from which you can retrieve an AccessPermissionDescription object.


The following tables list the members exposed by IAccessPermissionDescription.

Public Properties

 NameDescription
Public propertyAccessMaskA bitmask combining bit values representing the security access rights granted on a given object. The property behavior is as follows:
  • On an AccessPermission, the access rights are granted on a given object to the grantee specified on the access permission.
  • On an AccessPermissionDescription, the access rights are those that may be granted on a given object.
Public propertyPermissionTypeReturns the type (right or level) of the described permission.

Valid types are single (that is, a single access right), level (a commonly used combination of access rights), default level (that is, the recommended level for new permissions), and inherited (relevant only to child objects of the parent object described by the permission).

Top

See Also