QueryCategory

  • Article

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.

QueryCategory

The QueryCategory function fetches an item published in a specified enhanced presence container.

Syntax

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 R2 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);