PushSubscriptionRequest

Last modified: May 24, 2010

Applies to: Exchange Server 2007 | Exchange Server 2010

The PushSubscriptionRequest element represents a subscription to a push-based event notification subscription.

Subscribe
  PushSubscriptionRequest

<PushSubscriptionRequest SubscribeToAllFolders="">
   <FolderIds/>
   <EventTypes/>
   <Watermark/>
   <StatusFrequency/>
   <URL/>
</PushSubscriptionRequest>

PushSubscriptionRequestType

Attributes and Elements

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

Attributes

Attribute

Description

SubscribeToAllFolders

Indicates whether to subscribe to all available folders. This attribute is optional.

Child Elements

Element

Description

FolderIds

Contains an array of folder identifiers that are used to identify folders to monitor for event notifications.

EventTypes

Contains a collection of event notifications that are used to create a subscription.

Watermark

Represents an event bookmark in the mailbox events table. This is used to create a subscription starting at an event represented by the watermark. If the watermark from a Subscribe request is not found, an error response will be returned to the client. This may occur if the watermark is older than 30 days or if the watermark was never present in the mailbox.

StatusFrequency

Represents the frequency, specified in minutes, at which notification messages will be sent to the client when no events have occurred.

URL

Represents the location of the client Web service for push notifications.

Parent Elements

Element

Description

Subscribe

Contains the properties used to create subscriptions.

Text Value

None.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services of the Client Access server.

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/messages

Schema name

Messages schema

Validation file

Messages.xsd

Can be empty

False