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.


© 1997 by Microsoft Corporation. All rights reserved.