3.10 AddressBookRightsCollection

A collection of AddressBookRights objects.

3.10.1 Properties

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

Property

Access

Description

Application

R/O

Application. The Application object.

Count

R/O

Long. The number of objects in this collection.

_NewEnum

R/O

Enumeration object. Implements IEnumVARIANT. For Windows only.

Parent

R/O

AddressBook. The AddressBook object that owns this collection.

3.10.2 Methods

AddressBookRights Add(VARIANT Address, AddressBookRightsConstants AccessRights)

If Address is an Address object or an AddressBookEntry object, this method creates a new AddressBookRights object for that address. If Address is an Addresses collection, this method creates a new AddressBookRights object for each address in the collection. AccessRights specifies the rights given. See AddressBookRightsConstants.

Commit(String Subject, String BodyText)

"Shares" the address book with the users in the collection, and sends a message to them, with the given Subject and BodyText, notifying them that the address book has been shared with them.

AddressBookRights Item(VARIANT Index)

DEFAULT. Returns the AddressBookRights object specified by Index. Index may be a Long, an Address object, or an AddressBookEntry object. If Index is a Long, returns the AddressBookRights object located at the given Index in the collection. Valid indexes are 1 through Count, inclusive. Throws an exception if the Index is outside of this range. If Index is an Address object or an AddressBookEntry object, it should contain the DisplayName, EmailAddress, EmailType, and ObjType of the desired AddressBookRights object.

3.10.3 Remarks

An AddressBookRightsCollection is refreshed when its parent object is refreshed.