And
App
Day
End
ID
Ids
Not
Or
SID
To
TTL
UID
Url
Expand Minimize

UpdateItem

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

Last modified: February 07, 2014

Applies to: Exchange Online | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013 | Office 365


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

UpdateItemType

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.

SuppressReadReceipts

Indicates whether read receipts for the updated item should be suppressed. A text value of true indicates that read receipts should be suppressed. A value of false indicates that the read receipts will be sent to the sender. This attribute is optional.

This attribute was introduced in Exchange Server 2013 SP1.

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.

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

Namespace

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

Schema Name

Messages schema

Validation File

Messages.xsd

Can be Empty

False

Community Additions

ADD
Show:
© 2014 Microsoft