You can programmatically administer users and user groups, and the permissions granted to them in the group chat system, using the procedures described in the following table.

Task

Procedure

Create federated user groups

  1. Obtain a reference to GroupChatUserAdministrationServices .

  2. Invoke BeginCreateFederatedUserGroup(String, AsyncCallback, Object) .

Create federated users

  1. Obtain a reference to GroupChatUserAdministrationServices .

  2. Obtain a reference to the GroupChatFederatedUserGroup , where the user should be placed.

  3. Construct an instance of GroupChatFederatedUserSettings .

  4. Invoke BeginCreateFederatedUser(GroupChatFederatedUserSettings, AsyncCallback, Object) .

Move a federated user to a new federated user group

  1. Obtain a reference to GroupChatUserAdministrationServices .

  2. Obtain a reference to the GroupChatFederatedUser .

  3. Obtain a reference to the GroupChatFederatedUserGroup , where the user should be placed.

  4. Invoke BeginMoveFederatedUser(GroupChatFederatedUser, GroupChatFederatedUserGroup, AsyncCallback, Object) .

Delete a federated user group

  1. Obtain a reference to GroupChatUserAdministrationServices .

  2. Obtain a reference to the GroupChatFederatedUserGroup .

  3. Move all federated users from this group into a different federated user group.

  4. Invoke BeginDeleteFederatedUserGroup(GroupChatFederatedUserGroup, AsyncCallback, Object) .

Update a group chat user or user group permissions

  1. Obtain a reference to GroupChatUserAdministrationServices .

  2. Obtain a reference to the GroupChatUser or GroupChatUserGroup .

  3. Construct an instance of GroupChatUserInformation or GroupChatUserGroupInformation .

  4. Update the permissions of the principal.

  5. Invoke BeginUpdateUserOrGroupInformation(GroupChatPrincipalInformation, AsyncCallback, Object) .

Update a federated user or federated user group properties

  1. Obtain a reference to GroupChatUserAdministrationServices .

  2. Obtain a reference to the GroupChatFederatedUser or GroupChatFederatedUserGroup .

  3. Construct an instance of GroupChatFederatedUserInformation or GroupChatFederatedUserGroupInformation .

  4. Update the properties of the principal.

  5. Invoke BeginUpdateUserOrGroupInformation(GroupChatPrincipalInformation, AsyncCallback, Object) .