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

# XblSocialManagerCreateSocialUserGroupFromList

> XblSocialManagerCreateSocialUserGroupFromList

# XblSocialManagerCreateSocialUserGroupFromList

Constrói um XblSocialManagerUserGroup social, que é uma coleção de usuários com informações sociais.

## Sintaxe

```cpp theme={null}
HRESULT XblSocialManagerCreateSocialUserGroupFromList(  
         XblUserHandle user,  
         uint64_t* xboxUserIdList,  
         size_t xboxUserIdListCount,  
         XblSocialManagerUserGroupHandle* group  
)  
```

### Parâmetros

*user*   \_In\_\
Tipo: XblUserHandle

Usuário do XBOX Live.

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

Lista de usuários com os quais preencher o grupo de usuários sociais do XBOX. A lista não pode exceder XBL\_SOCIAL\_MANAGER\_MAX\_USERS\_FROM\_LIST.

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




O número de itens em xboxUserIdList.

*group*   \_Outptr\_result\_maybenull\_\
Tipo: [XblSocialManagerUserGroupHandle\*](/pt-BR/reference/live/xsapi-c/social_manager_c/handles/xblsocialmanagerusergrouphandle)

Retorna um identificador para o grupo criado. Esse grupo pode ser limpo posteriormente com XblSocialManagerDestroySocialUserGroup. O grupo também será limpo (invalidando o identificador retornado) se o usuário associado for removido do Social Manager.

### Valor retornado

Tipo: HRESULT

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

## Comentários

O resultado do carregamento de um grupo de usuários será disparado por meio do evento [XblSocialManagerEventType](/pt-BR/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype)::SocialUserGroupLoaded em [XblSocialManagerDoWork](/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork).

## Requisitos

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

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

## Confira também

[social\_manager\_c](/pt-BR/reference/live/xsapi-c/social_manager_c/social_manager_c_members)


## Related topics

- [XblSocialManagerCreateSocialUserGroupFromList](/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist.md)
- [Social Manager overview](/services/xbox-services/community/social-manager/live-social-manager-overview.md)
- [XblSocialManagerDestroySocialUserGroup](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdestroysocialusergroup.md)
- [XblSocialManagerUserGroupGetUsersTrackedByGroup](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetuserstrackedbygroup.md)
- [XblSocialManagerUpdateSocialUserGroup](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerupdatesocialusergroup.md)