2.2.2.28 MeetingStatus
As a top-level element of the Calendar class, the MeetingStatus element is an optional element that specifies whether the event is a meeting or an appointment, whether the event is canceled or active, and whether the user was the organizer. It is used in ActiveSync command requests and responses as specified in section 2.2.2.
As an optional child element of the Exception element, the MeetingStatus element specifies the status of the calendar item exception. The MeetingStatus element is not supported by certain protocol versions as a child of the Exception element. See the details about protocol versions at the end of this section. If the MeetingStatus element is not specified as a child element of an Exception element, the value of the MeetingStatus element for the exception is assumed to be the same as the value of the top-level MeetingStatus element.
The MeetingStatus element is defined as an element in the Calendar namespace. The value of this element is an unsignedByte data type, as specified in [MS-ASDTYPE] section 2.8.
The value of the MeetingStatus element MUST be one of the values listed in the following table.
|
Value |
Meaning |
|---|---|
|
0 |
The event is an appointment, which has no attendees. |
|
1 |
The event is a meeting and the user is the meeting organizer. |
|
3 |
This event is a meeting, and the user is not the meeting organizer; the meeting was received from someone else. |
|
5 |
The meeting has been canceled and the user was the meeting organizer. |
|
7 |
The meeting has been canceled. The user was not the meeting organizer; the meeting was received from someone else. |
|
9 |
Same as 1. |
|
11 |
Same as 3. |
|
13 |
Same as 5. |
|
15 |
Same as 7. |
The value of the MeetingStatus element is sent as an unsignedByte but SHOULD be parsed by the client based on the following bit flags.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
M |
R |
C |
unused (variable) |
||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
M - Meeting (1 bit): If set, the event is a meeting. If not set, the event is an appointment.
R - Received (1 bit): If set, the user is not the meeting organizer and the meeting was received from someone else. If not set, the user is the meeting organizer.
C – Cancelled (1 bit): If set, the meeting has been canceled. If not set, the meeting is active.
unused (variable): These bits are not used. MUST be zero, and MUST be ignored.
The top-level MeetingStatus element can be ghosted. For details about the use of ghosted properties, see [MS-ASCMD] section 2.2.3.179.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
|
Protocol version |
Element support, top-level |
Element support, child of Exception |
|---|---|---|
|
2.5 |
Yes |
|
|
12.0 |
Yes |
Yes |
|
12.1 |
Yes |
Yes |
|
14.0 |
Yes |
Yes |
|
14.1 |
Yes |
Yes |
|
16.0 |
Yes |
Yes |
|
16.1 |
Yes |
Yes |
When protocol version 2.5 is used, the MeetingStatus element is not supported as a child element of the Exception element.