IRTCClientPresence2
The IRTCClientPresence2 interface derives from the IRTCClientPresence interface. It adds roaming and grouping capabilities for presence objects to the client. This interface can be obtained by calling QueryInterface on the IRTCClientPresence interface.
Methods in Vtable Order
The IRTCClientPresence2 interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCClientPresence2 defines the following methods, including those inherited from IRTCClientPresence.
| Method | Description |
|---|---|
| EnablePresenceEx | Enables presence for a specific profile, attaching any buddies and watchers found in the specified local storage. |
| DisablePresence | Disables presence functionality on the client. The local store for buddies and watchers is closed and the buddy and watcher objects are destroyed. |
| AddGroup | Adds a new buddy group. |
| RemoveGroup | Removes a buddy group. |
| EnumerateGroups | Returns an enumeration of the groups available on this client. If there are no groups on this client, an empty enumeration is returned. |
| get_Groups | Gets a collection of the groups available on this client. If there are no groups on this client, an empty collection is returned. |
| get_Group | Gets an IRTCBuddyGroup interface for a group whose name matches the name given as a parameter. The group must be present for the function to succeed. |
| AddWatcherEx | Adds a new watcher to the allowed/blocked user list. |
| get_WatcherEx | Returns a watcher attached to the RTC client object, based on a supplied SIP URI. |
| put_PresenceProperty | Returns the standard presence property for the local user. |
| SetPresenceData | Sets application-specific information to be included in the presence document. |
| AddBuddyEx | Extends the capability of the IRTCClientPresence::AddBuddy method with the ability to define the type of subscriptions allowed for this buddy. |
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_IRTCClientPresence2 is defined as AD1809E8-62F7-4783-909A-29C9D2CB1D34.