IRTCClientPresence
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 contains all methods and properties related to a client presence.
.gif "Aa925740.security(en-us,MSDN.10).gif") Security Note: |
|---|
| The RTC Client API does not set ACLs on the presence storage file. |
Methods
The following table shows the methods for this interface in vtable order. This is the order in which the compiler calls the methods.
Like all COM interfaces, this interface inherits the methods for the IUnknown interface.
| 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. |
Obtaining a Pointer
The IRTCClientPresence 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.0 and later |