Represents the update status of a meeting request item.

Quick Info

Exposed on: Message objects used for scheduling
Created by: Outlook
Accessed by: Outlook and solution providers
Property type: PT_LONG
Access type: Read-only


To retrieve the value of this property, first use IMAPIProp::GetIDsFromNames to obtain the property tag, and then specify this property tag in IMAPIProp::GetProps to get the value. When calling IMAPIProp::GetIDsFromNames, specify the following values for the MAPINAMEID structure pointed at by the input parameter lppPropNames:

lpGuid: PSETID_Meeting
ulKind: MNID_ID
Kind.lID: dispidMeetingType

When Microsoft Office Outlook receives a meeting request item (which is an e-mail of message class IPM.Schedule.Meeting.Request), Outlook creates and sets this property for the item. The possible values of this property for a message which is a meeting request item are the following:

Value Status of Meeting Request Description
mtgNone None Outlook has not set this property for the message.
mtgRequest New Message is a new meeting request.
mtgFullUpdate Full update Message is a full update of a prior meeting request.
mtgInfoUpdate Informational update Message is an informational update of a prior meeting request.
mtgOutofDate Out-of-date Message is out-of-date and a more recent update has been sent to the recipient.
mtgDelegated Delegated Message is a copy of a meeting request, or a copy of an update of a prior meeting request received by the principal recipient. The original meeting request or the update has been sent to a delegate of the principal.

When Outlook receives a new meeting request, Outlook sets the dispidMeetingType property of the meeting request item to mtgRequest. If the recipient accepts the meeting request, any subsequent update of that meeting is either mtgFullUpdate (a full update) or mtgInfoUpdate (an informational update), depending on the cause of the update. A full update requires the attendee to explicitly accept the meeting request again, and an informational update does not. For more information about informational updates and full updates, see About Meeting Requests as Informational Updates and Full Updates.

If the recipient has not accepted an initial meeting request and receives a full update or an informational update, then Outlook assigns the dispidMeetingType property of the initial meeting request as mtgOutofDate, and the second meeting request mtgFullUpdate.

If a recipient has one or more delegates, delegates receive meeting requests and updates on behalf of the principal. Outlook sends the original meeting request or meeting request update to the delegates. And, by default, Outlook sends only a copy of these requests to the principal; these copies have dispidMeetingType set to mtgDelegated. An exception is when the message is marked Private. In this case, Outlook sends the message to only the principal; private messages have dispidMeetingType set to mtgRequest, mtgFullUpdate, or mtgInfoUpdate as appropriate.

See Also

Constants for Outlook Named Properties