NotificationType.PreviousWatermark プロパティ

定義

名前空間:

ExchangeWebServices

アセンブリ:

EWS.dll

プロパティは PreviousWatermark 、サブスクリプションのクライアントに正常に通信された最新のイベントの透かしを取得または設定します。

public:
 property System::String ^ PreviousWatermark { System::String ^ get(); void set(System::String ^ value); };

public string PreviousWatermark { get; set; }

Public Property PreviousWatermark As String

プロパティ値

String

プロパティは PreviousWatermark 、正常に通信された最後のイベントを含む文字列値を返します。

注釈

PreviousWatermark プロパティは、最後に成功した通知を決定する際にクライアントに役立ちます。 たとえば、サブスクリプションに透かし 1、2、3 の 3 つのイベントがあり、次の通知が PreviousWatermark 値 3 で送信された場合、クライアントはこの値を最後に受信した通知の透かし値と比較できます。 これにより、クライアントはイベントの継続性を確保できます。

プッシュ クライアントの場合、PreviousWatermark はローカルのクライアント側の最後の既知の透かしと比較されます。 値が異なる場合、クライアントはイベント通知を見逃しており、最新のローカル透かしを使用してサブスクリプションを再確立する必要があります。 たとえば、プッシュ クライアントが透かし 1、2、3 のサブスクリプションに対して 3 つのイベントを受信し、次の通知に PreviousWatermark 値が 5 である場合、クライアントは少なくとも 1 つの通知を見逃しており、透かしとして 3 を渡す新しいサブスクリプションを作成する必要があります。

プル クライアントの場合、PreviousWatermark の値は、GetEvents 呼び出しにクライアントによって含まれる透かしと同じになります。