3.52 FolderRights

Provides access rights to a folder.

3.52.1 Properties

The following table lists properties along with their access and descriptions.

Property

Access

Description

Address

R/O

Address. The address of the user to whom access rights are being granted.

AllowAdd

R/W

Boolean. TRUE if the user can add items to the folder.

AllowDelete

R/W

Boolean. TRUE if the user can remove items from the folder.

AllowModify

R/W

Boolean. TRUE if the user can modify items in the folder.

Application

R/O

Application. The Application object.

BitMask

R/W

Long. A bit mask that contains one bit for each Boolean property. See FolderRightsConstants for the bit definitions. This property is synchronized with the Boolean properties.

Parent

R/O

FolderRightsCollection. The FolderRightsCollection that owns this object.

3.52.2 Methods

Delete()

Removes this FolderRights object from its owning FolderRightsCollection, revokes the user’s access rights to the shared folder, and deletes the FolderRights object itself. When the last FolderRights object is deleted from a FolderRightsCollection, the owning folder ceases to be a shared folder. To unshare a folder, you must call the Commit method of the FolderRightsCollection after calling this Delete method.

3.52.3 Remarks

FolderRights properties are writable only by the folder owner.

A FolderRights object is refreshed when its parent object is refreshed. When a FolderRights object is refreshed, it recursively refreshes its Address object.

System folders cannot be shared with others users. The list of System folders includes the Mailbox, Calendar, Contacts, Sent Items, and Contacts folders.