| Platform SDK: CDO 1.2.1 |
The Submitted property is True when the message has been submitted to the MAPI system. Read/write.
objMessage.Submitted
Boolean
In general, there are three different kinds of messages: sent, posted, and saved. Sent messages are traditional e-mail messages sent to a recipient or public folder. Posted messages are created in a public folder. Saved messages are created and saved without either sending or posting.
For all three kinds of messages, you use the Sent, Submitted, and Unread properties and the Send or Update methods.
The following table summarizes the use of the message properties and methods for the three kinds of messages. In some systems the message store and transport providers are tightly coupled, in which case they bypass the spooler and perform its functions themselves.
| Kind of message | Method used | Sent property | Submitted property | Unread property |
|---|---|---|---|---|
| Sent | Send | Spooler sets True | Send sets True | Spooler sets True |
| Posted | Update | Application sets True | Application sets False | Application sets True |
| Saved | Update | Application sets False | Application sets False | Application sets True |
For sent and saved messages, the Submitted property is set to False before sending or saving the message. The messaging system also resets Submitted to False when the message arrives in a recipient's Inbox.
For posted messages, you create the message directly within a public folder and call the Update method. Some viewers do not allow the message to become visible to other users until you set the Submitted property to True.
For more information on sending and posting messages, see Creating and Sending a Message and Posting Messages to a Public Folder.
The Submitted property is not exposed on AppointmentItem objects created by Microsoft® Schedule+, and it is not automatically set when you create an appointment within a CDO application until you call the Update method. In these cases, the application must assign a value to Submitted or an attempt to read it returns CdoE_NOT_FOUND.
The Submitted property corresponds to the MSGFLAG_SUBMIT flag being set in the MAPI property PR_MESSAGE_FLAGS. It can be rendered into HTML hypertext using the CDO Rendering ObjectRenderer object. To specify this, set the object renderer's DataSource property to this Message object and the property parameter of the RenderProperty method to CdoPR_MESSAGE_FLAGS. However, you must assign a CDO Rendering Format object to the PR_MESSAGE_FLAGS property and use the Value property of the format's Pattern objects to isolate the MSGFLAG_SUBMIT flag's setting for rendering.