3.1.4.2.1 Messages
The following table summarizes the set of WSDL message definitions that are specific to the CreateItem operation.
Message name |
Description |
---|---|
CreateItemSoapIn |
The CreateItemSoapIn message is specified in [MS-OXWSCORE] section 3.1.4.2.1.1. It specifies the CreateItem operation request to create one or more calendar-related items on the server. The Items child element ([MS-OXWSCDATA] section 2.2.4.46) of the CreateItem element ([MS-OXWSCORE] section 3.1.4.2.2.1) that specifies the XML request MUST contain at least one of the following elements: § CalendarItemType (section 2.2.4.6) § AcceptItemType (section 2.2.4.1) § TentativelyAcceptItemType (section 2.2.4.27) § DeclineItemType (section 2.2.4.11) § CancelCalendarItemType (section 2.2.4.10) § RemoveItemType (section 2.2.4.26) The Items child element of the CreateItem element MUST NOT contain the following elements: § MeetingMessageType (section 2.2.4.15) § MeetingRequestMessageType (section 2.2.4.17) § MeetingCancellationMessageType (section 2.2.4.14) All other child elements of the CreateItem element MUST be empty. |
CreateItemSoapOut |
The CreateItemSoapOut message is specified in [MS-OXWSCORE] section 3.1.4.2.1.2. It specifies the server response to the CreateItem operation request. |
A successful CreateItem operation returns a CreateItemResponse element, as specified in [MS-OXWSCORE] section 3.1.4.2.2.2, with the ResponseClass attribute of the CreateItemResponseMessage element, as specified in [MS-OXWSCDATA] section 2.2.4.12, set to "Success". The ResponseCode element, as specified in [MS-OXWSCDATA] section 2.2.4.41, of the CreateItemResponseMessage element is set to "NoError".
If the request is unsuccessful, the CreateItem operation returns a CreateItemResponse element with the ResponseClass attribute of the CreateItemResponseMessage element set to "Error". The ResponseCode element of the CreateItemResponseMessage element is set to a value of the ResponseCodeType simple type, as specified in [MS-OXWSCDATA] section 2.2.5.24. The following table describes some of the possible error code values.
Value |
Description |
---|---|
ErrorCalendarDurationIsTooLong
|
Specifies that the item duration of a calendar item exceeds five years. |
ErrorCalendarEndDateIsEarlierThanStartDate
|
Specifies that the end date/time MUST be changed so that it is greater than the start date/time. |
ErrorCalendarInvalidDayForWeeklyRecurrence
|
Specifies that invalid values were used to specify the weekly recurrence.<68> |
ErrorCalendarInvalidRecurrence
|
Specifies that the internal structure of the objects that represent the recurrence is invalid. |