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
Returns the message's attachment table. |
|
Opens an attachment. |
|
Creates a new attachment. |
|
Deletes an attachment. |
|
Returns the message's recipient table. |
|
Adds, deletes, or modifies message recipients. |
|
Saves all changes to the message and marks it as ready for sending. |
|
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 |