This documentation is archived and is not being maintained.

Work with Enhanced Presence Using Unified Communications Client API

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Unified Communications Client API supports the publication and subscription of enhanced presence. In general, the API exposes the IUccCategoryInstance interface to represent enhanced presence. Commonly used enhanced presence defined by Office Communications Server and Office Communicator are encapsulated by special interfaces, such as IUccPresenceStateInstance, IUccPresenceNoteInstance, and IUccPresenceContactCardInstance.

To publish enhanced presence, a Unified Communications Client API client creates a publishable category instance and sets appropriate presence information on the created instance. For the special presence category instances, the latter step amounts to setting appropriate properties on the interface instance. For other presence category instances (including custom), setting the presence information involves assigning an XML blob as the value of an IUccCategoryInstance object. The XML blob must conform to the Unified Communications Enhanced Presence Schema, if the presence data is to be received and parsed by Communicator. For more information, see the Microsoft Unified Communications Client API documentation.