Share via


IMessage : IMAPIProp

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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