Watermark

Topic Last Modified: 2006-11-29

The Watermark element represents an event bookmark in the mailbox event queue.

Syntax

<Watermark/>

Type

WatermarkType

Attributes and Elements

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

Attributes

None.

Child Elements

None.

Parent Elements

Element Description

PullSubscriptionRequest

Represents a subscription to a pull-based event notification subscription.

PushSubscriptionRequest

Represents a subscription to a push-based event notification subscription.

GetEvents

Represents the operation used by pull clients to request notifications from the server.

CopiedEvent

Represents an event where an item or folder is copied.

CreatedEvent

Represents an event where an item or folder is created.

DeletedEvent

Represents an event where an item or folder is deleted.

ModifiedEvent

Represents an event where an item or folder is modified.

MovedEvent

Represents an event where an item or folder is moved from one parent folder to another parent folder.

NewMailEvent

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

StatusEvent

Represents a notification that no new activity has occurred in the mailbox.

SubscribeResponseMessage

Contains the status and result of a Subscribe request.

Text Value

A text value may be required or optional depending on how this element is used.

Remarks

If a Subscribe request contains a watermark, the subscription is created from the watermark forward. If the Subscribe request contains a watermark that is not found in the mailbox events table, an ErrorInvalidWatermark error is returned to the client application. This may occur if the watermark is too old and has been removed from the 30 day window of the events table or if the watermark was not ever present in the events table. This can happen, for example, if a watermark is obtained from a different subscription for a mailbox in a different database.

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