Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
| Method | Description |
|---|---|
| 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. |
Remarks
This event is fired when a buddy is added or removed from a group, or the group is renamed.
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_IRTCBuddyGroupEvent is defined as 3A79E1D1-B736-4414-96F8-BBC7F08863E4.