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 |
|---|---|
Identifies the target folder for operations that update, send, and create items in the Exchange store. |
|
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 |