Article
08/21/2009

UpdateItem

Topic Last Modified: 2006-06-11

The UpdateItem element defines a request to update an item in a mailbox.

Syntax

<UpdateItem ConflictResolution="" MessageDisposition="" SendMeetingInvitationsOrCancellations="">
   <SavedItemFolderId/>
   <ItemChanges/>
</UpdateItem>

Type

UpdateItemType

Attributes and Elements

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

Attributes

Attribute	Description
ConflictResolution	Identifies the type of conflict resolution to try during an update. The default value is AutoResolve.
MessageDisposition	Describes how the item will be handled after it is updated. The MessageDisposition attribute is required for message items, including meeting messages such as meeting cancellations, meeting requests, and meeting responses.
SendMeetingInvitationsOrCancellations	Describes how meeting updates are communicated after a calendar item is updated. This attribute is required for calendar items and calendar item occurrences.

ConflictResolution Attribute

Value	Description
NeverOverwrite	If there is a conflict, the update operation fails and an error is returned.
AutoResolve	The update operation automatically resolves any conflict.
AlwaysOverwrite	If there is a conflict, the update operation will overwrite information.

MessageDisposition Attribute

Value	Description
SaveOnly	The item is updated and saved back to its current folder.
SendOnly	The item is updated and sent but no copy is saved.
SendAndSaveCopy	The item is updated and a copy is saved in the folder identified by the SavedItemFolderId element.

SendMeetingInvitationsOrCancellations Attribute

Value	Description
SendToNone	The calendar item is updated but updates are not sent to attendees.
SendOnlyToAll	The calendar item is updated and the meeting update is sent to all attendees but is not saved in the Sent Items folder.
SendOnlyToChanged	The calendar item is updated and the meeting update is sent only to attendees that are affected by the change in the meeting.
SendToAllAndSaveCopy	The calendar item is updated, the meeting update is sent to all attendees, and a copy is saved in the Sent Items folder.
SendToChangedAndSaveCopy	The calendar item is updated, the meeting update is sent to all attendees that are affected by the change in the meeting, and a copy is saved in the Sent Items folder.

Child Elements

Element	Description
SavedItemFolderId	Identifies the target folder for operations that update, send, and create items in the Exchange store.
ItemChanges	Contains an array of ItemChange elements that identify items and the updates to apply to the items.

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

Share via