Message Object

 

Message Object

The Message object represents a single message, item, document, or form in a folder.

At a Glance

Specified in type library:	CDO.DLL
First available in:	CDO Library version 1.0.a
Parent objects:	Messages collection
Child objects:	Attachments collection Fields collection Recipients collection
Default property:	Subject

Properties

Name	Available since version	Type	Access
Application	1.0.a	String	Read-only
Attachments	1.0.a	Attachment object or Attachments collection object	Read-only
Categories	1.2	String array	Read/write
Class	1.0.a	Long	Read-only
Conversation	1.0.a	(Obsolete. Do not use.)	Read/write
ConversationIndex	1.0.a	String	Read/write
ConversationTopic	1.0.a	String	Read/write
DeliveryReceipt	1.0.a	Boolean	Read/write
Encrypted	1.0.a	Boolean	Read/write
Fields	1.0.a	Field object or Fields collection object	Read-only
FolderID	1.0.a	String	Read-only
ID	1.0.a	String	Read-only
Importance	1.0.a	Long	Read/write
MAPIOBJECT	1.0.a	IUnknown object	Read/write (Note: Not available to Visual Basic applications)
Parent	1.0.a	Messages collection object	Read-only
ReadReceipt	1.0.a	Boolean	Read/write
Recipients	1.0.a	Recipients object or Recipients collection object	Read/write
Sender	1.0.a	AddressEntry object	Read/write
Sensitivity	1.2	Long	Read/write
Sent	1.0.a	Boolean	Read/write
Session	1.0.a	Session object	Read-only
Signed	1.0.a	Boolean	Read/write
Size	1.0.a	Long	Read-only
StoreID	1.0.a	String	Read-only
Subject	1.0.a	String	Read/write
Submitted	1.0.a	Boolean	Read/write
Text	1.0.a	String	Read/write
TimeCreated	1.2	Variant (vbDate format)	Read-only
TimeExpired	1.2	Variant (vbDate format)	Read/write
TimeLastModified	1.2	Variant (vbDate format)	Read-only
TimeReceived	1.0.a	Variant (vbDate format)	Read/write
TimeSent	1.0.a	Variant (vbDate format)	Read/write
Type	1.0.a	String	Read/write
Unread	1.0.a	Boolean	Read/write

Methods

Name	Available since version	Parameters
CopyTo	1.1	folderID as String, (optional) storeID as String
Delete	1.0.a	(optional) DeletedItems as Boolean
Forward	1.2	(none)
IsSameAs	1.1	objMessage2 as Object
MoveTo	1.1	folderID as String, (optional) storeID as String
Options	1.0.a	(optional) parentWindow as Long
Reply	1.2	(none)
ReplyAll	1.2	(none)
Send	1.0.a	(optional) saveCopy as Boolean, (optional) showDialog as Boolean, (optional) parentWindow as Long
Update	1.0.a	(optional) makePermanent as Boolean, (optional) refreshObject as Boolean

Remarks

Microsoft® Visual Basic® programmers can create new Message objects using the Messages collection’s Add method.

C/C++ programmers can create new Message objects with the OLE function CoCreateInstance.

A message can be obtained from its parent Messages collection using the collection’s Item property. To get to the Messages collection in a folder, use the Folder object’s Messages property. If you know a message’s unique identifier, you can obtain it directly from the Session object’s GetMessage method.

A Message object can be rendered into HTML hypertext using the CDO Rendering ObjectRenderer object. To specify this, set the object renderer's DataSource property to the Message object itself. The individual properties that can be rendered with the RenderProperty method are indicated in the Message object property descriptions.

A Message object can also be rendered as the parent of a Recipients collection, using the ContainerRenderer object. The individual properties that can be rendered with the RenderProperty method are indicated in the Message object property descriptions.