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 .

Inheritance Hierarchy

System . . :: . . Object
   Microsoft.Rtc.Collaboration.GroupChat . . :: . . ChatRoomCategory

Namespace:  Microsoft.Rtc.Collaboration.GroupChat
Assembly:  Microsoft.Rtc.Collaboration.GroupChat(in Microsoft.Rtc.Collaboration.GroupChat.dll)


Visual Basic (Declaration)
Visual Basic (Usage)


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 Widening Implicit Implicit 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 < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object) .

Thread Safety

Any public static( Sharedin Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also