> ## 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

# XblSocialManagerUpdateSocialUserGroup

Atualiza o grupo de usuários sociais especificado para um novo grupo de usuários.

## Sintaxe

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

### Parâmetros

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

O grupo de usuários sociais do Xbox a ser atualizado.

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

Nova lista de usuários a serem rastreados. Observe que isso substitui a lista existente de usuários rastreados. A lista não pode exceder XBL\_SOCIAL\_MANAGER\_MAX\_USERS\_FROM\_LIST.

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

Número de itens na matriz de usuários.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Comentários

Faz uma comparação para ver quais usuários foram adicionados ou removidos. O resultado da atualização de um grupo de usuários será disparado por meio do evento [XblSocialManagerEventType](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype.md)::SocialUserGroupUpdated em [XblSocialManagerDoWork](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork.md). Chame esta API depois de chamar [XblSocialManagerCreateSocialUserGroupFromFilters](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters.md) ou [XblSocialManagerCreateSocialUserGroupFromList](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist.md) para criar um XblSocialManagerUserGroup. Tenha o XblSocialManagerUserGroupHandle retornado pelo evento [XblSocialManagerEventType](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype.md)::SocialUserGroupLoaded em [XblSocialManagerDoWork](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork.md).

## Requisitos

**Cabeçalho:** social\_manager\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

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


## Related topics

- [Visão geral do Social Manager](https://docs.xbox.com/pt-BR/services/xbox-services/community/social-manager/live-social-manager-overview.md)
- [social_manager_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/social_manager_c_members.md)
- [XblSocialManagerEventType](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype.md)
- [XblSocialManagerDestroySocialUserGroup](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdestroysocialusergroup.md)
- [XblSocialManagerCreateSocialUserGroupFromFilters](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters.md)