OccurrenceItemId

Topic Last Modified: 2008-08-19

The OccurrenceItemId element identifies a single occurrence of a recurring item.

Syntax

<OccurrenceItemId RecurringMasterId="" ChangeKey="" InstanceIndex=""/>

Type

OccurrenceItemIdType

Attributes and Elements

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

Attributes

Attribute Description

RecurringMasterId

Identifies the recurring master of a recurring item. This attribute is required.

ChangeKey

Identifies a specific version of the recurring master or an item occurrence. If either the recurring master or any of its occurrences change, the ChangeKey changes. The ChangeKey is the same for the recurring master and all occurrences.

InstanceIndex

Identifies the index of the item occurrence. This attribute is required. This value represents an integer.

Child Elements

None.

Parent Elements

Element Description

ItemIds

Contains the unique identities of items, occurrence items, and recurring master items that are 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
Aa580744.note(en-us,EXCHG.80).gifNote:
MoveItem Operation and CopyItem Operation only work with single calendar items and recurring master items. Item occurrences are invalid with these operations

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]

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.

Example

The following example identifies the fourth occurrence of a recurring item that has the identity 34vswe4.

<OccurrenceItemId RecurringMasterId="34vswe4" InstanceIndex="4" />

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

Reference

RecurringMasterItemId