IRTCBuddyGroupEvent
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
Note
This interface is unsupported in Windows Embedded CE 6.0.
This interface retrieves information about an event of type RTCE_GROUP. This type of event is used when roaming group information is updated. It is triggered when a buddy is added to or removed from a group, or the group is renamed.
Methods
The following table shows the methods for this interface in vtable order. This is the order in which the compiler calls the methods. This interface inherits the methods for the IUnknown and IDispatch interfaces.
The following table shows the IDispatch methods.
| Method | Description |
|---|---|
Maps a single member name and an optional set of parameter names to a corresponding set of integer dispatch identifiers (DISPIDs). These identifiers can then be used on subsequent calls to IDispatch::Invoke. |
|
Retrieves the type information for an object. |
|
Retrieves the number of type information interfaces provided by an object, either zero (0) or 1. |
|
Provides access to properties and methods exposed by an object. |
The following table shows the IRTCBuddyGroupEvent methods.
| Method | Description |
|---|---|
Gets the event type. |
|
Gets the buddy group associated with this event. |
|
Gets the buddy group associated with this event. |
|
Gets the result code of the completed operation. |
Obtaining a Pointer
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT enumeration value of RTCE_GROUP, the method's pEvent parameter is an IDispatch pointer for the IRTCBuddyGroupEvent interface.
Remarks
To enable reception of buddy group events, the application must call the IRTCClient::EventFilter method and set an event filter mask that includes the RTCE_GROUP event. If the application does not call IRTCClient::EventFilter, it will not receive any events.
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |