DeleteItem

Topic Last Modified: 2006-06-11

The DeleteItem element defines a request to delete an item from a mailbox in the Exchange store.

Syntax

<DeleteItem DeleteType="" SendMeetingCancellations="" AffectedTaskOccurrences="">
   <ItemIds/>
</DeleteItem>

Type

DeleteItemType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description

DeleteType

Describes how an item is deleted. This attribute is required.

SendMeetingCancellations

Describes whether a calendar item deletion is communicated to attendees. This attribute is required when calendar items are deleted. This attribute is optional if non-calendar items are deleted.

AffectedTaskOccurrences

Describes whether a task instance or a task master is deleted by a DeleteItem Operation. This attribute is required when tasks are deleted. This attribute is optional when non-task items are deleted.

DeleteType Attribute

Value Description

HardDelete

An item is permanently removed from the store.

SoftDelete

An item is moved to the dumpster if the dumpster is enabled.

MoveToDeletedItems

An item is moved to the Deleted Items folder.

SendMeetingCancellations Attribute

Value Description

SendToNone

A calendar item is deleted without sending a cancellation message.

SendOnlyToAll

A calendar item is deleted and a cancellation message is sent to all attendees.

SendToAllAndSaveCopy

A calendar item is deleted and a cancellation message is sent to all attendees. A copy of the cancellation message is saved in the Sent Items folder.

AffectedTaskOccurrences Attribute

Value Description

AllOccurrences

A delete item request deletes the master task, and therefore all recurring tasks that are associated with the master task.

SpecifiedOccurrenceOnly

A delete item request deletes only specific occurrences of a task.

Child Elements

Element Description

ItemIds

Contains an array of items, occurrence items, and recurring master items to delete from a mailbox in the Exchange store. The DeleteItem Operation can be performed on any item type.

Parent Elements

None.

Remarks

The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/messages

Schema Name

Messages schema

Validation File

Messages.xsd

Can be Empty

False