Watermark

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
http://schemas.microsoft.com/exchange/services/2006/types
Schema name
Types schema
Validation file
Types.xsd
Can be empty
False

See also

Subscribe operation

GetEvents operation

Unsubscribe operation