QueryCategory(string or Uri,int,string,int,bool) function
Communications Server 2007 Server SDK Documentation |
QueryCategory
The QueryCategory function fetches an item published in a specified enhanced presence container.
string QueryCategory( string or Uri Publisher, int ContainerNumber, string CategoryName, int Instance, bool PublisherIsPhone );
Parameters
- Publisher
The identity of the presence publisher. Can be a SIP URI, a user URI in the form user@host, or a telephone number. - ContainerNumber
The container identification number. - CategoryName
The name of the presence category. - Instance
The instance identification number. - PublisherIsPhone
Optional. The value is true if the publisher is a phone; otherwise, false.
Return Values
Returns the specified string.
Remarks
Office Communications Server 2007 provides the infrastructure to enable client applications to publish and subscribe to extended, or "enhanced," presence information. The enhanced presence infrastructure includes categories and containers. Categories are individual pieces of presence information, such as status, location, or calendar state. Containers are logical buckets into which clients publish instances of various categories of presence information.
Example Code
publication = QueryCategory("sip:someone@example.com", 1, "userStatus", 0);
Example Code
publication = QueryCategory("someone@example.com", 1, "userCalendarState", 0, false);
Example Code
publication = QueryCategory("+14255551234", 1, "userLocation", 0, true);
What did you think of this topic? |
© 2007 Microsoft Corporation. All rights reserved. |