Publishing Enhanced Presence
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.
In addition to basic presence availability, you can publish updates to a local user's enhanced presence information including presence note and contact card identity properties.
You can publish either a new instance of an enhance presence category or publish an update to a previously published enhance presence category. Your user may have previously published an instance of the contactCard category to container 100, but never published an instance of contactCard to container 200. If your user elects to add contactCard to container 200 so that the members of 200 have access to the contactCard, your application must create a new instance of contactCard where its ContainerId property is set to 200. In contrast, if your user wants to update a telephone number in the instance of contactCard previously published in container 100, your application must first obtain the previously published category instance, derive a publishable instance from it, modify that instance, and then publish it again.
In addition to publishing entirely new enhanced presence categories, you can derive new enhanced presence categories from previously published categories. This is done by obtaining a published category from a container, creating a new publishable instance of it, and publishing the new instance to a different container. This technique is useful when a user intends to publish the contact card previously published in a container to a new container where, for example, the mobile phone number is a personal cell phone rather than a company cell phone. In this case, all other identity properties of the contactCard are not changed.
Note
If the target container contains an instance of the category to be published, it is replaced by the derived category.
The topics in this section discuss how to publish an enhanced presence category. For more information about basic publication, see Publishing and Subscribing.
In This Section
Find Previously Published Enhanced Presence Category
Create a New Enhanced Presence Category Instance
Update and Publish Enhanced Presence Category
Code Listing: Contact and Container Classes