IRTCClientPresence2
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 adds roaming and grouping capabilities for presence objects to the client. Itextends the IRTCClientPresence interface.
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 IRTCClientPresence interfaces.
The following table shows the IRTCClientPresence methods.
| Method | Description |
|---|---|
Enables the presence functionality for both outgoing and incoming subscriptions. |
|
Exports a snapshot of the current lists of buddies and blocked or allowed watchers. |
|
Imports presence information, such as the buddy list and allowed or blocked watcher list. |
|
Gets an enumeration of buddies available on the client. |
|
Gets a collection of the buddies available on the client. |
|
Gets a buddy whose presentity Universal Resource Identifier (URI) matches the supplied URI. |
|
Adds a buddy to the buddy list. |
|
Removes a buddy from the buddy list. |
|
Retrieves an enumeration of the allowed and blocked watchers available on this client. |
|
Gets a watcher whose present URI matches the supplied URI. |
|
Gets a collection of the watchers available on this client. |
|
Adds a watcher to the allowed or blocked watcher list. |
|
Removes a watcher from the watcher list. |
|
Sets the local presence status. |
|
Sets or gets the way the RTC Client API handles subscription requests by new watchers that are not in the list of allowed or blocked watchers. |
|
Sets or gets the privacy mode for the user. |
The following table shows the IRTCClientPresence2 methods.
| Method | Description |
|---|---|
Enables the presence for a specific profile, attaching buddies and watchers found in the specified local storage. |
|
Disables the presence functionality on the client. |
|
Adds a new buddy group. |
|
Removes a buddy group. |
|
Retrieves an enumeration of the groups available on this client. |
|
Gets a collection of the groups available on this client. |
|
Gets the buddy group that matches the specified name. |
|
Adds a watcher to the allowed or blocked user list. |
|
Gets a watcher attached to the RTC Client object, based on a supplied SIP URI. |
|
Sets or gets the standard presence property for the local user. |
|
Sets application-specific data to be included in the presence document. |
|
Retrieves application-specific information included in the presence document. |
|
Retrieves the application-specific information from the presence document |
|
Allows the application to define the type of subscriptions allowed for a buddy. |
Obtaining a Pointer
The IRTCClientPresence2 interface is created by calling IUnknown::QueryInterface on the IRTCClient object.
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |