Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The PR_MESSAGE_FLAGSproperty contains a bitmask of flags indicating the origin and current state of a message.

Additional Information

Must be exposed by:

Message objects

Identifier:

0x0E07

Property type:

PT_LONG

Property tag:

0x0E070003

Remarks

The PR_MESSAGE_FLAGSproperty is a nontransmittable message property exposed at both the sending and receiving ends of a transmission, with different values depending upon the client application or store provider involved. This property is initialized by the client or message store provider when a message is created and saved for the first time and then updated periodically by the message store provider, a transport provider, and the MAPI spooler as the message is processed and its state changes.

PR_MESSAGE_FLAGSexists on a message both before and after submission, and on all copies of the received message. Although it is not a recipient property, it is exposed differently to each recipient according to whether it has been read or modified by that recipient.

One or more of the following flags can be set for PR_MESSAGE_FLAGS:

MSGFLAG_FROMME

The messaging user sending was the messaging user receiving the message. This flag is meant to be set by the transport provider.

MSGFLAG_READ

The message is marked as having been read. Clients can set this flag by calling a message's IMAPIProp::SetPropsmethod before the message has been saved for the first time. This flag is ignored if the MSGFLAG_ASSOCIATEDflag is set.

MSGFLAG_UNSENT

The message is still being composed. It is saved, but has not been sent. Typically, this flag is cleared after the message is sent.

A client or message store provider can check the current state of the message at any time by calling the IMAPIProp::GetPropsmethod to read the flag values. The client or provider can also call the IMAPIProp::SetPropsmethod to change any flags that currently have read/write access.

The initial value for PR_MESSAGE_FLAGSis typically MSGFLAG_UNSENTto indicate a message that has not yet been sent.

Message store providers set the MSGFLAG_UNMODIFIEDflag for incoming messages. MSGFLAG_UNMODIFIEDindicates that a message has not been changed since delivery. A client cannot clear this value after it has been set by a message store provider.

Requirements

Header mapitags.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also