The Messages collection object contains zero or more Message objects.
| 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 |
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 |
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) |
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.