PreviousWatermark
Das PreviousWatermark-Element stellt das Wasserzeichen des letzten Ereignisses dar, das dem Client für das Abonnement erfolgreich mitgeteilt wurde.
<PreviousWatermark/>
WatermarkType
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Keine.
Keine.
Element | Beschreibung |
---|---|
Benachrichtigung |
Enthält Informationen zum Abonnement und zu den Ereignissen, die seit der letzten Benachrichtigung aufgetreten sind. |
Ein Textwert ist erforderlich. Der Textwert stellt das neueste Wasserzeichen dar. Der Textwert darf keine leere Zeichenfolge sein.
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 und eine 3 als Wasserzeichen übergeben.
Im Fall eines Pullclients entspricht der Wert von PreviousWatermark dem Wasserzeichen , das vom Client im GetEvents-Aufruf enthalten ist.
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.
Name | Wert |
---|---|
Namespace |
http://schemas.microsoft.com/exchange/services/2006/types |
Name des Schemas |
Schematypen |
Überprüfungsdatei |
Types.xsd |
Leer kann sein |
False |