PullSubscriptionRequest

The PullSubscriptionRequest element represents a subscription to a pull-based event notification subscription.

Subscribe

PullSubscriptionRequest

<PullSubscriptionRequest SubscribeToAllFolders="">
   <FolderIds/>
   <EventTypes/>
   <Watermark/>
   <Timeout/>
</PullSubscriptionRequest>

PullSubscriptionRequestType

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 that starts at an event that is represented by the watermark. If the watermark from a Subscribe request is not found, an error response will be returned to the client. This error may occur if the watermark is older than 30 days or if the watermark was never present in the mailbox.
Timeout
Represents the duration, in minutes, that the subscription can remain idle without a GetEvents request from the client.

Parent elements

Element Description
Subscribe
Contains the properties that are 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.

Element information

Name Value
Namespace
http://schemas.microsoft.com/exchange/services/2006/messages
Schema name
Messages schema
Validation file
Messages.xsd
Can be empty
False

See also

PushSubscriptionRequest

Subscribe operation

GetEvents operation

Unsubscribe operation