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

# XblSocialManagerUserGroupGetUsersTrackedByGroup

> XblSocialManagerUserGroupGetUsersTrackedByGroup

# XblSocialManagerUserGroupGetUsersTrackedByGroup

Obtém um ponteiro para uma matriz, de propriedade da XSAPI, de xuids rastreados pelo grupo.

## Sintaxe

```cpp theme={null}
HRESULT XblSocialManagerUserGroupGetUsersTrackedByGroup(  
         XblSocialManagerUserGroupHandle group,  
         const uint64_t** trackedUsers,  
         size_t* trackedUsersCount  
)  
```

### Parâmetros

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

O grupo do qual obter os usuários.

*trackedUsers*   \_Outptr\_result\_maybenull\_\
Tipo: uint64\_t\*\*

Retorna um ponteiro para a matriz de xuids rastreados. A memória do ponteiro retornado permanece válida até a próxima vez que [XblSocialManagerDoWork](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork.md) for chamada.

*trackedUsersCount*   \_Out\_\
Tipo: size\_t\*

Retorna o tamanho da matriz de usuários rastreados.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Para grupos baseados em lista, o conjunto de usuários rastreados é estático (ou seja, a lista de xuids fornecida quando o grupo é criado), mas para grupos baseados em filtro, o conjunto de usuários rastreados muda à medida que os relacionamentos do usuário local mudam. 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

- [social_manager_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/social_manager_c_members.md)
- [XblSocialManagerUserGroupGetUsers](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetusers.md)
- [XblSocialManagerUserGroupGetLocalUser](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetlocaluser.md)
- [XblSocialManagerUserGroupGetType](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgettype.md)
- [XblSocialManagerUserGroupGetFilters](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetfilters.md)