IMessage : IMAPIProp

Applies to: Outlook

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