3.1.4.3.1 Messages

The following table summarizes the set of WSDL message definitions that are specific to the DeleteItem operation.

Message name

Description

DeleteItemSoapIn

The DeleteItemSoapIn message is specified in [MS-OXWSCORE] section 3.1.4.3.1.1. It specifies the DeleteItem operation request to delete one or more calendar-related items on the server.

The DeleteItem element ([MS-OXWSCORE] section 3.1.4.3.2.1) that specifies the XML request MUST contain the ItemIds child element ([MS-OXWSCORE] section 3.1.4.3.3.2).

For each item being deleted that is not a recurring calendar item, the ItemIds element MUST contain an ItemId child element ([MS-OXWSCORE] section 2.2.4.31).

For each item being deleted that is a recurring calendar item, the ItemIds element can contain a RecurringMasterItemId child element ([MS-OXWSCORE] section 2.2.4.39) or an  OccurrenceItemId child element ([MS-OXWSCORE] section 2.2.4.35).

DeleteItemSoapOut

The DeleteItemSoapOut message is specified in [MS-OXWSCORE] section 3.1.4.3.1.2. It specifies the server response to the DeleteItem operation request.

A successful DeleteItem operation returns a DeleteItemResponse element, as specified in [MS-OXWSCORE] section 3.1.4.3.2.2, with the ResponseClass attribute of the DeleteItemResponseMessage 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 DeleteItemResponseMessage element is set to "NoError".

If the request is unsuccessful, the DeleteItem operation returns a DeleteItemResponse element with the ResponseClass attribute of the DeleteItemResponseMessage element set to "Error". The ResponseCode element of the DeleteItemResponseMessage 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

ErrorCalendarCannotUseIdForOccurrenceId

Specifies that the OccurrenceId ([MS-OXWSCORE] section 2.2.4.39) does not correspond to a valid occurrence of a recurring master item.

ErrorSendMeetingCancellationsRequired

Occurs during a DeleteItem call, when the SendMeetingCancellations property is missing from the request and the item to delete is a calendar item. If you are using the proxy objects, make sure that the SendMeetingCancellationsSpecified property is set to true.

ErrorCalendarInvalidPropertyState

Specifies that the state of the calendar item recurrence binary large object (BLOB) in the message store is invalid.

ErrorCalendarInvalidRecurrence

Specifies that the internal structure of the objects that represent the recurrence is invalid.