2.2.3.92.1 InstanceId (MeetingResponse)
The InstanceId element is an optional child element of the Request element in MeetingResponse command requests and an optional child element of the Result element in MeetingResponse command responses that specifies the instance of the recurring meeting to be modified.
Elements referenced in this section are defined in the MeetingResponse namespace, except where otherwise indicated by the presence of a namespace prefix (as defined in section 2.2.4).
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
MeetingResponse command request (section 2.2.1.11) |
Request (section 2.2.3.150.2) |
None |
string ([MS-ASDTYPE] section 2.7) |
0...1 (optional) |
|
MeetingResponse command response |
Result (section 2.2.3.155.2) |
None |
string |
0...1 (optional) |
The InstanceId element contains the original, unmodified, UTC date and time of the appointment or meeting instance to be modified. If the InstanceId element is not included in the MeetingResponse request, then the action is to be taken on every instance of the recurring item. The InstanceId element can specify the start time of an exception to a recurring appointment or meeting.
The InstanceId element can be used with the search:LongId element (section 2.2.3.98.2) to identify a calendar item, or it can be used with the CollectionId (section 2.2.3.30.4) and RequestId (section 2.2.3.151) elements to identify a calendar item.
The format of the InstanceId value is a string in dateTime ([MS-ASDTYPE] section 2.3) format with the punctuation separators, for example, 2010-04-08T18:16:00.000Z. If the InstanceId element passes schema validation but the value is not specified in the proper format, the server responds with a Status element (section 2.2.3.177.9) value of 104. If the InstanceId element value specifies a non-recurring meeting, the server responds with a Status element value of 146. A Status element value of 2 or an HTTP 400 response is returned if the request includes the InstanceId element when a non-supporting protocol version is used.<9> Details about protocol versions are provided at the end of this section.
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 |
|---|---|
|
2.5 |
|
|
12.0 |
|
|
12.1 |
|
|
14.0 |
|
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |
The InstanceId element is included in a MeetingResponse command response only when protocol version 16.0 or 16.1 is used.