Retrieves the appropriate interface for events.

Syntax

HRESULT GetWatcher(      
    FEEDS_EVENTS_SCOPE scope,
    FEEDS_EVENTS_MASK mask,
    IDispatch **disp
);

Parameters

scope

[in] A FEEDS_EVENTS_SCOPE value that limits the extent of events notifications to be received.

mask

[in] A combination of FEEDS_EVENTS_MASK values that specify the source of events.

disp

[out, retval] Address of a pointer variable of type IDispatch that receives the event callback.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Although the signatures for IFeed::GetWatcher and IFeedFolder::GetWatcher are the same, requesting a folder watcher from a feed object returns E_INVALIDARG.

See Also

Events in the Windows RSS Platform