Managing Roles and Scope

To use the Group Chat API to manage roles on a ChatRoom , use the following methods:

Method	Description
BeginGetMembers(Uri, AsyncCallback, Object)	Gets a list of users and user groups having the role of member. The result set is returned as a collection of GroupChatRoleDescriptor objects, which describe the user or user group having the role, the category from which the role was inherited (if applicable), and the change history of this data.
BeginGetManagers(Uri, AsyncCallback, Object)	Gets a list of users and user groups having the role of manager.
BeginGetPresenters(Uri, AsyncCallback, Object)	Gets a list of users and user groups having the role of presenter.
BeginFindUsersOrGroupsForRole(ChatRoomRole, Uri, String, AsyncCallback, Object)	Gets a list of users and user groups who are eligible for the role. Use this method to find users before invoking the next two methods.
BeginAddUsersOrGroupsToRole(ChatRoomRole, Uri, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object)	Adds a list of users to the specified role on a chat room.
BeginRemoveUsersOrGroupsFromRole(ChatRoomRole, Uri, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object)	Removes a list of users from the specified role on a chat room.

To use the Group Chat API to manage roles on a ChatRoomCategory , use the following methods:

Method	Description
BeginGetMembers(Uri, AsyncCallback, Object)	Gets a list of users and user groups having the role of member. The result set is returned as a collection of GroupChatRoleDescriptor objects, which describe the user or user group having the role, the category from which the role was inherited (if applicable), and the change history of this data.
BeginGetManagers(Uri, AsyncCallback, Object)	Gets a list of users and user groups having the role of manager.
BeginFindUsersOrGroupsForRole(ChatRoomRole, Uri, String, AsyncCallback, Object)	Gets a list of users and user groups who are eligible for the role. Use this method to find users before invoking the next two methods.
BeginAddUsersOrGroupsToRole(ChatRoomRole, Uri, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object)	Adds a list of users to the specified role on a chat room.
BeginRemoveUsersOrGroupsFromRole(ChatRoomRole, Uri, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object)	Removes a list of users from the specified role on a chat room.

To use the Group Chat API to manage scope on a ChatRoomCategory , use the following methods:

Method	Description
BeginFindUsersOrGroupsForScope(Uri, String, AsyncCallback, Object)	Gets a list of users and user groups who are eligible for scope. Use this method to find users before invoking the BeginSetScope(ChatRoomCategory, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object) method described in the next row of this table. Because scope can only be narrowed, this method only returns principals who are included in the set of principals defined by the scope of the parent category.
BeginSetScope(ChatRoomCategory, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object)	Replaces the scope of the category with the specified list of principals. The list of principals supplied must be a subset of the current scope defined by the parent category, or this call will fail.

Method

Description

BeginFindUsersOrGroupsForScope(Uri, String, AsyncCallback, Object)

Gets a list of users and user groups who are eligible for scope. Use this method to find users before invoking the BeginSetScope(ChatRoomCategory, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object) method described in the next row of this table. Because scope can only be narrowed, this method only returns principals who are included in the set of principals defined by the scope of the parent category.

BeginSetScope(ChatRoomCategory, ICollection < (Of < <' ( GroupChatPrincipalSummary > ) > > ) , AsyncCallback, Object)

Replaces the scope of the category with the specified list of principals. The list of principals supplied must be a subset of the current scope defined by the parent category, or this call will fail.