The IRTCBuddyGroupEvent interface contains methods and properties describing the buddy group event. RTCE_BUDDYGROUP events have an IRTCBuddyGroupEvent interface. This type of event is fired when roaming group information is updated.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_GROUP, the method's pEvent parameter is an IDispatch pointer for the IRTCBuddyGroupEvent interface.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCE_BUDDYGROUP event to enable reception of buddy group events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.
Methods in Vtable Order
The IRTCBuddyGroupEvent interface inherits the methods of the standard COM interfaces:
In addition, IRTCBuddyGroupEvent defines the following methods.
|get_EventType||Returns the event type.|
|get_Group||Gets the IRTCBuddyGroup interface for the buddy group associated with this event.|
|get_Buddy||Gets the IRTCBuddy interface for the buddy group associated with this event.|
|get_StatusCode||Returns the result code of the operation that has completed.|
This event is fired when a buddy is added or removed from a group, or the group is renamed.
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_IRTCBuddyGroupEvent is defined as 3A79E1D1-B736-4414-96F8-BBC7F08863E4.