Share via


IRTCWatcherEvent2

The IRTCWatcherEvent2 interface derives from IRTCWatcherEvent. RTCE_WATCHER events have an IRTCWatcherEvent2 interface. This type of event is fired when there is an incoming request for monitoring the local user that is not already in the list of blocked/allowed watchers, or when roaming watcher information is updated.

When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_WATCHER, the method's pEvent parameter is an IDispatch pointer for the IRTCWatcherEvent2 interface.

Note  You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_WATCHER2 event to enable reception of RTC 1.2 Watcher events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.

Methods in Vtable Order

The IRTCWatcherEvent2 interface inherits the methods of the standard COM interface IUnknown.

In addition, IRTCWatcherEvent2 defines the following methods, including those inherited from IRTCWatcherEvent.

Method Description
get_EventType Returns the event type.
get_StatusCode Returns the result code of the operation that has completed.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCWatcherEvent2 is defined as E52891E8-188C-49AF-B005-98ED13F83F9C.