Share via


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

See Also

Reference

UpdateItem Operation