Submitted Message Properties

Platform SDK: Exchange Server

Submitted Message Properties

Messages passing through your gateway may have properties in addition to the common message properties. The following table shows optional properties for a submitted message and indicates actions that your gateway should take when handling messages with these properties.

Optional Submitted Message Properties

Property name	Type	Description
PR_DELETE_AFTER_SUBMIT	Boolean	If present and set, indicates that the server should delete the message after submission.
PR_SENTMAIL_ENTRYID	Binary	Entry identifier of the folder where a copy of the message should be placed after it has been successfully submitted to an underlying messaging system. If zero-length, it indicates that no sent mail copy should be made. If this property does not exist, sent mail behavior is governed by the profile configuration.

A gateway uses the MAPI IMessage::SubmitMessage method to submit a message to Microsoft Exchange Server. When Microsoft Exchange Server takes responsibility, the following actions will occur:

If the PR_DELETE_AFTER_SUBMIT property is set, the information store deletes the message. Gateways typically set this property so that their MTS-IN folders do not accumulate large numbers of messages.
If the PR_SENTMAIL_ENTRYID property is set, the information store copies the message to the indicated folder. Gateways can use this property to implement archiving features.

A gateway uses the MAPI IMessage::SetReadFlag method when it accepts responsibility for delivering a message to the foreign system. After the gateway has called this function, Microsoft Exchange Server cannot time-out the message.