> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblSocialManagerUpdateSocialUserGroup

> XblSocialManagerUpdateSocialUserGroup

Updates specified social user group to new group of users.

## Syntax

```cpp theme={null}
HRESULT XblSocialManagerUpdateSocialUserGroup(  
         XblSocialManagerUserGroupHandle group,  
         uint64_t* users,  
         size_t usersCount  
)  
```

### Parameters

*group*   \_In\_\
Type: [XblSocialManagerUserGroupHandle](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/handles/xblsocialmanagerusergrouphandle.md)

The social user group to update.

*users*   \_In\_\
Type: uint64\_t\*

New list of users to track. Note that this replaces the existing list of tracked users. The list cannot exceed XBL\_SOCIAL\_MANAGER\_MAX\_USERS\_FROM\_LIST.

*usersCount*   \_In\_\
Type: size\_t

Number of items in the users array.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

Does a diff to see which users have been added or removed. The result of a user group being updated will be triggered through the [XblSocialManagerEventType](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype.md)::SocialUserGroupUpdated event in [XblSocialManagerDoWork](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork.md). Call this API after calling either [XblSocialManagerCreateSocialUserGroupFromFilters](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters.md) or [XblSocialManagerCreateSocialUserGroupFromList](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist.md) to create an XblSocialManagerUserGroup. Have the XblSocialManagerUserGroupHandle returned by the [XblSocialManagerEventType](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype.md)::SocialUserGroupLoaded event in [XblSocialManagerDoWork](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork.md).

## Requirements

**Header:** social\_manager\_c.h

**Library:** Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

## See also

[social\_manager\_c](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/social_manager_c_members.md)


## Related topics

- [Social Manager overview](https://docs.xbox.com/services/xbox-services/community/social-manager/live-social-manager-overview.md)
- [social_manager_c (contents)](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/social_manager_c_members.md)
- [XblSocialManagerEventType](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype.md)
- [XblSocialManagerDestroySocialUserGroup](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdestroysocialusergroup.md)
- [XblSocialManagerCreateSocialUserGroupFromList](https://docs.xbox.com/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist.md)