Dela via


ItemId

Topic Last Modified: 2009-07-16

The ItemId element contains the unique identifier and change key of an item in the Exchange store.

Syntax

<ItemId Id="" ChangeKey="" />

Type

ItemIdType

Attributes and Elements

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

Attributes

Attribute Description

Id

Identifies a specific item in the Exchange store. This attribute is case-sensitive, so comparisons between Ids must be case-sensitive or binary.

ChangeKey

Identifies a specific version of an item. A ChangeKey is required for the following scenarios:

  • The UpdateItem element requires a ChangeKey if the ConflictResolution attribute is set to AutoResolve. AutoResolve is a default value. If the ChangeKey attribute is not included, the response will return a ResponseCode value equal to ErrorChangeKeyRequired.
  • The SendItem element requires a ChangeKey to test whether the attempted operation will act upon the most recent version of an item. If the ChangeKey attribute is not included in the ItemId or if the ChangeKey is empty, the response will return a ResponseCode value equal to ErrorStaleObject.

Child Elements

None.

Parent Elements

Element Description

CalendarItem

Represents an Exchange calendar item.

Contact

Represents an Exchange contact item.

CopiedEvent

Represents an event when an item or folder is copied.

CreatedEvent

Represents an event when an item or folder is created.

Delete (ItemSync)

Identifies a single item to delete in the local client store.

DeletedEvent

Represents an event when an item or folder is deleted.

DistributionList

Represents a distribution list.

FirstOccurrence

Represents the first occurrence of a recurring calendar item.

Ignore

Identifies items to skip during synchronization.

Item

Represents a generic Exchange item.

ItemChange

Contains an item identifier and the updates to apply to the item.

The following is the XPath expression to this element: 

/UpdateItem/ItemChanges/ItemChange[i]

ItemIds

Contains the unique identities of items, occurrence items, and recurring master items used to delete, send, get, move, or copy items in the Exchange store.

The following are the XPath expressions to this element:

  • /DeleteItem/ItemIds
  • /SendItem/ItemIds
  • /GetItem/ItemIds
  • /MoveItem/ItemIds
  • /CopyItem//ItemIds

LastOccurrence

Represents the last occurrence of a recurring calendar item.

Mailbox

Identifies a mail-enabled Active Directory directory service object.

MeetingCancellation

Represents a meeting cancellation in the Exchange store.

MeetingMessage

Represents a meeting in the Exchange store.

MeetingRequest

Represents a meeting request in the Exchange store.

MeetingResponse

Represents a meeting response in the Exchange store.

Message

Represents an Exchange e-mail message.

ModifiedEvent

Represents an event that occurs when an item is modified.

MovedEvent

Represents an event that occurs when an item is moved from one parent folder to another parent folder.

NewMailEvent

Represents an event that is triggered by a new mail item in a mailbox.

Occurrence

Represents a single modified occurrence of a recurring calendar item.

RemoveItem

Removes an item from the Exchange store.

Task

Represents a task in the Exchange store.

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/types

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False

See Also

Other Resources

Exchange Web Services XML Elements