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.
Describes a chat room category. A chat room category is a logical structure for organizing chat rooms. To obtain a reference to a ChatRoomCategory, and access other metadata about it, see CategoryManagementServices.
Assembly: Microsoft.Rtc.Collaboration.GroupChat (in Microsoft.Rtc.Collaboration.GroupChat.dll)
Chat room categories may contain chat rooms as well as other categories, forming a hierarchy. Each category describes its contents with metadata such as Name and Description. In addition, the category has properties which can be set to control the behavior of the chat rooms and subcategories nested within it. The category also defines a default set of access control lists for controlling the users and user groups who may join or manage the chat rooms.
To browse or modify the member list, and other roles defined by a category, use CategoryManagementServices. Many of the methods on this class accept a ChatRoomCategorySummary. For ease of use, this class supports an implicit conversion (see Implicit(ChatRoomCategory to ChatRoomCategorySummary)).
Finally, a chat room category defines a scope which is enforced on all chat rooms and subcategories within it. The scope of a category is a list of user groups and/or users who can:
See the chat rooms and categories when searching
Be added to the member list of the chat room or category
The top-level category, which is called the root category, is referenced by RootCategoryUri. The scope of the root category is defined during installation to include the entire domain of the installing user. It may be extended to include additional domains, child domains, or even federated user groups. To change the scope of a category, use BeginSetScope(ChatRoomCategory, ICollection<GroupChatPrincipalSummary>, AsyncCallback, Object).