Partager via


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.