Messages Collection Object (CDONTS Library)

  • Article

 

Messages Collection Object (CDONTS Library)

The Messages collection object contains zero or more Message objects.

At a Glance

Specified in type library:

CDONTS.DLL

First available in:

CDO for NTS Library version 1.2

Parent objects:

Folder

Child objects:

Message

Default property:

Item

Properties

Name

Available since version

Type

Access

Application

1.2

String

Read-only

Class

1.2

Long

Read-only

Count

1.2

Long

Read-only

Item

1.2

Message object

Read-only

Parent

1.2

Folder object

Read-only

Session

1.2

Session object

Read-only

Methods

Name

Available since version

Parameters

Add

1.2

(optional) subject as String, (optional) text as Object or String, (optional) importance as Long

Delete

1.2

(none)

GetFirst

1.2

(none)

GetLast

1.2

(none)

GetNext

1.2

(none)

GetPrevious

1.2

(none)

Remarks

The order that messages are returned by GetFirst, GetLast, GetNext, and GetPrevious is not predictable. The best programming approach to use with unsorted collections is to assume that the access functions are able to access all messages within the collection, but that the order of the objects is not defined.

The CDO for NTS Library does not permit any modifications to messages in the Inbox, other than deleting the entire message. Prohibited modifications include adding, deleting, or modifying any attachment; adding, deleting, or modifying any recipient; and modifying any message property, even one with read/write access.