Share via


Contact Group Management

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.

Managing contact groups involves creating a group, adding a contact to a group, removing a contact from a group, and deleting a group. A contact group represented by an IUccGroup interface contains a collection of contacts returned by a query to the Contacts property.

Group Types

  • User-Defined Group
    User-defined groups represented by the enumeration UCC_GROUP_TYPE. UCCGT_USER_DEFINED_GROUP. The user-defined group is a simple group container to which your contacts can be added. You can add and remove contacts to a user-defined group using Unified Communications Client API. User-defined groups are always provisioned in-band and in expanded state. At the time a user is logged on to an Office Communications Server, her user-defined groups are sent to the client along with all other subscribed data. Office Communications Server sends all group members along with the group itself.
  • Distribution Group
    The distribution group is represented by the enumeration UCC_GROUP_TYPE. UCCGT_DISTRIBUTION_GROUP. This is the same distribution group of contacts you use in your e-mail application to send group e-mail. With a distribution group, you can add contacts to your contact list in bulk and start IM and audio/video conferences with a single operation. The users contained within a distribution group are maintained globally by a server administrator. This means you are freed from the responsibility of adding, changing, and removing contacts from your list when they change in a distribution group. Office Communications Server provisions your subscribed distribution groups in collapsed state. You do not receive the individual distribution group members with the distribution group itself. A separate expansion request must be made out of band. The request is made to a Web service supplied by Office Communicator. The Web service URL is available when you query the ServerConfiguration category (IUccServerConfigurationCategory).

In This Section

Create a Contact Group

Create a Distribution Group

Add a Contact to a Contact Group

Move a Contact to Another Contact Group

Remove a Contact from a Contact Group

Rename a Contact Group

Remove a Contact Group

Handle Contact Group Events

See Also

Concepts

Create Contact List Subscription
Receive Contact List
Add a Contact to the Contact List
Remove a Contact from the Contact List
Receive User's Presence States
Presence Availability State
Granting Permissions to View Published Presence States
Sample Contact Presence Handling Class