IRTCClientPresence
The IRTCClientPresence interface contains all methods and properties related to presence. This interface can be obtained by performing a QueryInterface on the Client object.
Methods in Vtable Order
The IRTCClientPresence interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCClientPresence defines the following methods.
| Method | Description |
|---|---|
| EnablePresence | Enables the presence functionality for both outgoing and incoming subscriptions. |
| Export | Exports a snapshot of the current lists of Buddies and blocked or allowed Watchers. |
| Import | Imports presence information such as the list of buddies and allowed/blocked Watchers. |
| EnumerateBuddies | Returns an enumeration of Buddies available on this Client. If there are no Buddies on this Client, an empty enumeration is returned. This method is intended for C and C++ applications. Visual Basic applications should use the get_Buddies method. |
| get_Buddies | Gets a collection of the Buddies available on this Client. If there are no Buddies on this Client, an empty collection is returned. This method is intended for applications written in Visual Basic. C and C++ applications should use the EnumerateBuddies method. |
| get_Buddy | Gets an IRTCBuddy interface for a Buddy whose presentity URI matches the URI given as a parameter. The Buddy must be present in the list of buddies for the function to succeed. |
| AddBuddy | Adds a Buddy to the list of buddies. |
| RemoveBuddy | Removes a Buddy from the list of buddies. |
| EnumerateWatchers | Returns an enumeration of the allowed and blocked Watchers available on this Client. If there are no Watchers on this Client, an empty enumeration is returned. This method is intended for C and C++ applications. Visual Basic applications should use the get_Watchers method. |
| get_Watchers | Gets a collection of the Watchers available on this Client. If there are no Watchers on this Client, an empty collection is returned. This method is intended for applications written in Visual Basic. C and C++ applications should use the EnumerateWatchers method. |
| get_Watcher | Gets an IRTCWatcher interface for a Watcher whose presentity URI matches the URI given as a parameter. The Watcher must be present in the allowed/blocked Watchers list for the function to succeed. |
| AddWatcher | Adds a Watcher to the allowed/blocked Watchers list. |
| RemoveWatcher | Removes a Watcher from the Watcher list. |
| SetLocalPresenceInfo | Sets the local presence status. All the active Watchers are instantly notified of the change. |
| get_OfferWatcherMode | Retrieves the way the application handles subscriptions requested by new Watchers that are not currently in the list of allowed or blocked Watchers. |
| put_OfferWatcherMode | Determines how the application handles subscription requests from new Watchers that are not in the list of allowed or blocked Watchers. |
| get_PrivacyMode | Gets the privacy mode. |
| put_PrivacyMode | Sets the privacy mode. |
Requirements
Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClientPresence is defined as 11c3cbcc-0744-42d1-968a-51aa1bb274c6.