IMessage : IMAPIProp
Last modified: July 23, 2011
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 |
|
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 |