3.13 AllMessages

Contains all messages in an account.

3.13.1 Properties

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

Property

Access

Description

Application

R/O

Application. The Application object.

_NewEnum

R/O

Enumeration object. Implements IEnumVARIANT. For Windows only.

Parent

R/O

Account. The Account object that owns this collection.

3.13.2 Methods

AllMessagesIterator CreateAllMessagesIterator()

Creates an AllMessagesIterator object for iterating over the messages in this collection.

MessageList Find(VARIANT Condition)

Returns a list of messages matching the Condition specified. Condition may be either a string or a Filter object. If Condition is a string, it represents a filter expression. See Section 5.0, Filter Expressions. If Condition is a Filter object, it represents a saved Filter. To save the overhead of instantiating a messages collection, callers of the API should use the Find method in the AllMessages collection if they do not already have a messages collection or when searching across folders. Once a message collection has been obtained, there is no loss of efficiency to call its Find method.

3.13.3 Remarks

Because AllMessages is a large collection, it does not support a Count property or an Item method. You can access its elements using an iterator object or using the GetMessage method of the parent Account object to access a message by MessageID.

An AllMessages collection is refreshed when its parent object is refreshed. When an AllMessages collection is refreshed, it updates the Message objects in the collection, but it does not recursively refresh the Message objects themselves