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.