Add Method

Adds a new right to the collection.

Syntax

Function Add(
    ID As Long) As SecurityRight

Parameters

ID

The right's ID. See CeSystemRights and CeReportRights for a list of Crystal Enterprise security rights and their IDs.

Remarks

Use this function to set a specific right on an object for a particular principal. The Crystal Enterprise system defines a set of rights that apply to the objects in the system. These rights can be retrieved with the KnownRights Property, and then individually added to the principal's SecurityRights collection. Rights that have not been added to the collection are considered to be "not specified."

A role's predefined rights are automatically added to the SecurityRights Collection. As soon as a principal is given specific rights to an object, the role automatically becomes set to the Advanced mode.

To determine whether a right that is added to the collection is an owner right—a right that the principal will have only if it is the owner of the object—use the Owner Property.