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.

 

Show: