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

# 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](/pt-BR/reference/live/xsapi-c/social_manager_c/handles/xblsocialmanagerusergrouphandle)

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](/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 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](/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters) ou [XblSocialManagerCreateSocialUserGroupFromList](/pt-BR/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist) para criar um XblSocialManagerUserGroup. Tenha o XblSocialManagerUserGroupHandle retornado pelo 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

- [XblSocialManagerUserGroupGetUsersTrackedByGroup](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetuserstrackedbygroup.md)
- [XblSocialManagerUserGroupGetUsers](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetusers.md)
- [XblSocialManagerUpdateSocialUserGroup](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerupdatesocialusergroup.md)