PidTagMessageStatus Canonical Property
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Contains a 32-bit bitmask of flags that defines the status of a message in a contents table.
Associated properties: |
PR_MSG_STATUS |
Identifier: |
0x0E17 |
Data type: |
PT_LONG |
Area: |
General messaging |
Remarks
A message can exist in a contents table and in one or more search-results tables, and each instance of the message can have a different status. This property should not be considered a property on a message but a column in a contents table.
A client application can set one or more of the following flags in this property:
MSGSTATUS_ANSWERED
The message has been replied to.MSGSTATUS_DELMARKED
The message has been marked for subsequent deletion.MSGSTATUS_DRAFT
The message is in draft revision status.MSGSTATUS_HIDDEN
The message is to be suppressed from recipients' folder displays.MSGSTATUS_HIGHLIGHTED
The message is to be highlighted in recipients' folder displays.MSGSTATUS_REMOTE_DELETE
The message has been marked for deletion at the remote message store without downloading to the local client.MSGSTATUS_REMOTE_DOWNLOAD
The message has been marked for downloading from the remote message store to the local client.MSGSTATUS_TAGGED
The message has been tagged for a client-defined purpose.
The MSGSTATUS_DELMARKED, MSGSTATUS_HIDDEN, MSGSTATUS_HIGHLIGHTED, and MSGSTATUS_TAGGED flags are defined by the client. Transport and store providers pass these bits without any action.
Clients can interpret these values in any way that is appropriate for their applications. One way that many clients use this property is to display messages marked for deletion with a representative icon.
A remote viewer client can set MSGSTATUS_REMOTE_DELETE or MSGSTATUS_REMOTE_DOWNLOAD on messages in the header folder presented to it by the remote transport provider. The client application can examine each message header in this folder to determine whether the message should be downloaded or deleted at the remote message store. It then uses the IMAPIFolder::SetMessageStatus method to set the appropriate flag. SetMessageStatus is the only way to set any of the flags in this property; the IMAPIProp::SetProps method cannot be used. To retrieve this property, clients call IMAPIFolder::GetMessageStatus rather than IMAPIProp::GetProps.
Bits 16 through 31 (0x10000 through 0x80000000) of this property are available for use by the interpersonal message (IPM) client application. All other bits are reserved for use by MAPI; those not defined in the preceding table should be initially set to zero and not altered subsequently.
Related Resources
Protocol Specifications
[MS-OXPROPS]
Provides references to related Exchange Server protocol specifications.[MS-OXCSYNC]
Handles synchronizing messaging object data between a server and a client.
Header Files
Mapidefs.h
Provides data type definitions.Mapitags.h
Contains definitions of properties listed as alternate names.