QueryCategoryBySubscriber

Applies to: Lync 2013 | Lync Server 2013

QueryCategoryBySubscriber

The QueryCategoryBySubscriber function fetches an item published in a specified enhanced presence container, which is selected based on the access control lists (ACLs) associated with the indicated Subscriber and Source Network.

Syntax

string QueryCategoryBySubscriber(
  string or Uri Publisher,
  string Subscriber,
  string ExternalSourceNetwork,
  string CategoryName,
  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.

• Subscriber
  The identity of the presence subscriber. Must be in the form user@host.

• ExternalSourceNetwork
  The identity of the presence subscriber. Must be in the form user@host.

• CategoryName
  The name of the presence category. Valid category names are "userProperties", "workingHours", "dndState", "routing" and "contactCard".

• PublisherIsPhone
  Optional. The value is true if the publisher is a phone; otherwise, false.

Return values

Returns an XML string representation of the specified presence category if the category name is "userProperties", "workingHours", "dndState", "routing" or "contactCard". Otherwise, the function returns null.

Remarks

Microsoft Lync Server 2013 provides the infrastructure to enable client applications to publish and subscribe to 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.