IMessage : IMAPIProp

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Manages messages, attachments, and recipients.

Header file:	Mapidefs.h
Exposed by:	Message object
Implemented by:	Message store providers
Called by:	Client applications
Interface identifier:	IID_IMessage
Pointer type:	LPMESSAGE
Transaction model:	Transacted

Vtable Order

GetAttachmentTable	Returns the message's attachment table.
OpenAttach	Opens an attachment.
CreateAttach	Creates a new attachment.
DeleteAttach	Deletes an attachment.
GetRecipientTable	Returns the message's recipient table.
ModifyRecipients	Adds, deletes, or modifies message recipients.
SubmitMessage	Saves all changes to the message and marks it as ready for sending.
SetReadFlag	Sets or clears the MSGFLAG_READ flag in the PR_MESSAGE_FLAGS (PidTagMessageFlags) property of the message and manages the sending of read reports.

The following properties are required on messages at some point during their lifecycle. Most of the read-only properties are set by the message store provider when a client calls a message's IMAPIProp::SaveChanges method. Other read-only properties are set by the transport provider.

Required properties for messages of all classes	Access
PR_CREATION_TIME (PidTagCreationTime)	Read-only
PR_DISPLAY_BCC (PidTagDisplayBcc)	Read-only
PR_DISPLAY_CC (PidTagDisplayCc)	Read-only
PR_DISPLAY_TO (PidTagDisplayTo)	Read-only
PR_ENTRYID (PidTagEntryId)	Read-only
PR_LAST_MODIFICATION_TIME (PidTagLastModificationTime)	Read-only
PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments)	Read-only
PR_MESSAGE_CLASS (PidTagMessageClass)	Read/write
PR_MESSAGE_FLAGS (PidTagMessageFlags)	Read/write
PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients)	Read-only
PR_MESSAGE_SIZE (PidTagMessageSize)	Read-only
PR_MESSAGE_CC_ME (PidTagMessageCcMe)	Read-only
PR_MESSAGE_RECIP_ME (PidTagMessageRecipientMe)	Read-only
PR_MESSAGE_TO_ME (PidTagMessageToMe)	Read-only
PR_NORMALIZED_SUBJECT (PidTagNormalizedSubject)	Read-only
PR_ORIGINATOR properties	Read-only
PR_PARENT_DISPLAY (PidTagParentDisplay)	Read-only
PR_PARENT_ENTRYID (PidTagParentEntryId)	Read-only
PR_RECEIVED_BY properties	Read-only
PR_RECIPIENT_TYPE (PidTagRecipientType)	Read-only
PR_RECORD_KEY (PidTagRecordKey)	Read-only
PR_SEARCH_KEY (PidTagSearchKey)	Read-only
PR_SENDER properties	Read-only
PR_STORE_ENTRYID (PidTagStoreEntryId)	Read-only
PR_STORE_RECORD_KEY (PidTagStoreRecordKey)	Read-only

The following properties are all read-only to clients, with the exception of PR_BODY. Clients construct this property when they process a report.

Properties for report messages
PR_BODY (PidTagBody)
PR_CONVERSATION_INDEX (PidTagConversationIndex)
PR_CONVERSATION_TOPIC (PidTagConversationTopic)
PR_MESSAGE_CLASS
PR_MESSAGE_DELIVERY_TIME (PidTagMessageDeliveryTime)
PR_ORIGINAL_DELIVERY_TIME (PidTagOriginalDeliveryTime)
PR_ORIGINAL_DISPLAY_BCC (PidTagOriginalDisplayBcc)
PR_ORIGINAL_DISPLAY_CC (PidTagOriginalDisplayCc)
PR_ORIGINAL_DISPLAY_TO (PidTagOriginalDisplayTo)
PR_ORIGINAL_SUBJECT (PidTagOriginalSubject)
PR_ORIGINAL_SUBMIT_TIME (PidTagOriginalSubmitTime)
PR_REPORT_TAG (PidTagReportTag)
PR_REPORT_TEXT (PidTagReportText)
PR_REPORT_TIME (PidTagReportTime)
PR_SEARCH_KEY
PR_SENDER properties
PR_SUBJECT (PidTagSubject)

Properties for message recipients	Access	Required or optional
PR_ADDRTYPE (PidTagAddressType)	Read-only	Required
PR_DISPLAY_NAME (PidTagDisplayName)	Read/write	Required
PR_DISPLAY_TYPE (PidTagDisplayType)	Read/write	Required
PR_EMAIL_ADDRESS (PidTagEmailAddress)	Read-only	Optional
PR_ENTRYID	Read-only	Required
PR_OBJECT_TYPE (PidTagObjectType)	Read-only	Required
PR_SEARCH_KEY	Read-only	Optional