Watermark

Article
03/29/2023

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

<Watermark/>

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 MicrosoftExchange Server 2007 that has the Client Access server role installed.

Element information

Name	Value
Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema name	Types schema
Validation file	Types.xsd
Can be empty	False