PreviousWatermark

Das PreviousWatermark-Element stellt das Wasserzeichen des letzten Ereignisses dar, das dem Client für das Abonnement erfolgreich mitgeteilt wurde.

<PreviousWatermark/>

WatermarkType

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Keine.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
Benachrichtigung	Enthält Informationen zum Abonnement und zu den Ereignissen, die seit der letzten Benachrichtigung aufgetreten sind.

Textwert

Ein Textwert ist erforderlich. Der Textwert stellt das neueste Wasserzeichen dar. Der Textwert darf keine leere Zeichenfolge sein.

HinwBemerkungeneise

Die PreviousWatermark-Eigenschaft ist für den Client nützlich, um die letzte erfolgreiche Benachrichtigung zu bestimmen. Wenn ein Abonnement beispielsweise drei Ereignisse mit den Wasserzeichen 1, 2 und 3 aufweist und die nächste Benachrichtigung mit dem Wert PreviousWatermark von 3 gesendet wird, kann der Client diesen Wert mit dem Wasserzeichenwert der letzten empfangenen Benachrichtigung vergleichen. Dadurch kann der Client die Kontinuität von Ereignissen sicherstellen.

Bei Pushclients wird previousWatermark mit dem lokalen, clientseitigen letzten bekannten Wasserzeichen verglichen. Wenn sich die Werte unterscheiden, hat der Client eine Ereignisbenachrichtigung verpasst und sollte ein Abonnement mithilfe des neuesten lokalen Wasserzeichens wiederherstellen. Wenn ein Pushclient beispielsweise drei Ereignisse für ein Abonnement mit den Wasserzeichen 1, 2 und 3 empfängt und die nächste Benachrichtigung den Wert PreviousWatermark von 5 aufweist, hat der Client mindestens eine Benachrichtigung verpasst und sollte ein neues Abonnement erstellen, wobei eine 3 als Wasserzeichen übergeben wird.

Im Fall eines Pullclients entspricht der Wert von PreviousWatermark dem Wasserzeichen , das der Client im GetEvents-Aufruf enthält.

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, der Microsoft Exchange Server 2007 mit installierter Clientzugriff-Serverrolle ausführt.

Informationen zu Elementen

Name	Wert
Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Name des Schemas	Schematypen
Überprüfungsdatei	Types.xsd
Leer kann sein	False

Siehe auch

Vorgang abonnieren

GetEvents-Vorgang

Vorgang des Kündigens von Abonnements