NotificationType.PreviousWatermark Property

The PreviousWatermark property gets or sets the watermark of the latest event that was successfully communicated to the client for the subscription.

Namespace: ExchangeWebServices
Assembly: EWS (in ews.dll)

Syntax

'Declaration
Public Property PreviousWatermark As String
public string PreviousWatermark { get; set; }
public:
property String^ PreviousWatermark {
    String^ get ();
    void set (String^ value);
}
/** @property */
public String get_PreviousWatermark ()

/** @property */
public void set_PreviousWatermark (String value)
public function get PreviousWatermark () : String

public function set PreviousWatermark (value : String)

Property Value

The PreviousWatermark property returns a string value that contains the last event that was successfully communicated.

Remarks

The PreviousWatermark property is useful to the client in determining the last successful notification. For example, if a subscription has three events with watermarks 1, 2, and 3, and the next notification is sent with a PreviousWatermark value of 3, the client can compare this value to the Watermark value of the last notification received. This enables the client to ensure the continuity of events.

For push clients, the PreviousWatermark is compared to the local, client-side last known watermark. If the values are different, the client has missed an event notification and should reestablish a subscription by using the latest local watermark. For example, if a push client receives three events for a subscription with watermarks 1, 2, and 3, and the next notification includes a PreviousWatermark value of 5, the client has missed at least one notification and should create a new subscription, passing a 3 as the watermark.

For pull clients, the value of PreviousWatermark will be the same as the Watermark that is included by the client in the GetEvents call.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003,

Target Platforms

Windows 98, Windows 2000, Windows 2000 Server, Windows CE, Windows Longhorn, Windows 98 Second Edition, Pocket PC, Smart Phone, Windows Server 2003, Windows XP Professional with Service Pack 2 (SP2)