IRTCBuddyEvent2
The IRTCBuddyEvent2 interface derives from the IRTCBuddyEvent interface. This type of event is fired when the presence state of a buddy changes, or when roaming buddy information is updated.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_BUDDY, the method's pEvent parameter is an IDispatch pointer for the IRTCBuddyEvent2 interface.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_BUDDY2 event to enable reception of RTC 1.2–specific Buddy events. If you do not call IRTCClient::put_EventFilter, your application will not receive these events.
Methods in Vtable Order
The IRTCBuddyEvent2 interface inherits the methods of the standard COM interfaces:
In addition, IRTCBuddyEvent2 defines the following methods.
| Method | Description |
|---|---|
| get_EventType | Returns the event type. |
| get_StatusCode | Gets the result code of the operation that has completed. |
| get_StatusText | Gets the status text string 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_IRTCBuddyEvent2 is defined as 484A7F1E-73F0-4990-BFC2-60BC3978A720.