UpdateItem
The UpdateItem element defines a request to update an item in a mailbox.
<UpdateItem ConflictResolution="" MessageDisposition="" SendMeetingInvitationsOrCancellations="" SuppressReadReceipts="">
<SavedItemFolderId/>
<ItemChanges/>
</UpdateItem>
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. |
| 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.
Remarks
The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.
Element information
| Name | Value |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
| Schema Name |
Messages schema |
| Validation File |
Messages.xsd |
| Can be Empty |
False |