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

# XblProfileGetUserProfilesForSocialGroupAsync

> XblProfileGetUserProfilesForSocialGroupAsync

# XblProfileGetUserProfilesForSocialGroupAsync

Obtém os perfis dos usuários em um grupo social especificado.

## Sintaxe

```cpp theme={null}
HRESULT XblProfileGetUserProfilesForSocialGroupAsync(  
         XblContextHandle xboxLiveContext,  
         const char* socialGroup,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*xboxLiveContext*   \_In\_\
Tipo: [XblContextHandle](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Um identificador de contexto do XBOX Live criado com XblContextCreateHandle.

*socialGroup*   \_In\_z\_\
Tipo: char\*

O nome codificado em UTF-8 do grupo social de usuários a ser pesquisado. As opções são "Favorites" e "People".

*async*   \_In\_\
Tipo: XAsyncBlock\*

AsyncBlock alocado pelo chamador.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Para obter o resultado, primeiro chame [XblProfileGetUserProfilesForSocialGroupResultCount](/pt-BR/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresultcount) para obter a contagem de perfis retornados e, em seguida, chame [XblProfileGetUserProfilesForSocialGroupResult](/pt-BR/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult) dentro do retorno de chamada do AsyncBlock ou após a conclusão do AsyncBlock.

## Chamada REST

Chama V2 GET /users/{userId}/profile/settings/people/{socialGroup}

## Requisitos

**Cabeçalho:** profile\_c.h

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

## Confira também

[profile\_c](/pt-BR/reference/live/xsapi-c/profile_c/profile_c_members)


## Related topics

- [XblProfileGetUserProfilesForSocialGroupAsync](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)
- [XblProfileGetUserProfilesForSocialGroupResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult.md)
- [XblProfileGetUserProfilesForSocialGroupResultCount](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresultcount.md)