IMessage : IMAPIProp
Applies to: Outlook 2013 | Outlook 2016
Manages messages, attachments, and recipients.
| Property | Value |
|---|---|
| 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
| Member | Description |
|---|---|
| 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 |