Edit

StatusEvent

  • Article

The StatusEvent element represents a notification that no new activity has occurred in the mailbox.

<StatusEvent>
   <Watermark/>
</StatusEvent>

BaseNotificationEventType

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child elements

Element Description
Watermark
Represents the last valid watermark for a subscription.

Parent elements

Element Description
Notification
Contains information about the subscription and the events that have occurred since the last notification.

Remarks

The StatusEvent element is returned in a notification for one of the following reasons:

  • A pull client issues a GetEvents request on a subscription that has no activity.

  • A push client has no events in the queue when the StatusFrequency has been reached.

The StatusEventWatermark is used by a client application in the same manner as the other event type watermarks. However, the watermark for the StatusEvent is not the same as the watermarks used for other events. For example, a subscription has events with watermarks 1, 2, and 3 and those events have been successfully communicated in a notification. A period of inactivity occurs and a GetEvents request is sent. The Client Access server (CAS) returns a status event and includes the last watermark, 3, as both the PreviousWatermark and the current Watermark.

The watermark will not remain the same in all cases. Event entries are maintained for 30 days. To maintain an active subscription, the CAS periodically updates the watermarks for subscription queues. The updated watermarks are sent to clients to maintain an active subscription.

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
https://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