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

# XblPresenceGetPresenceForSocialGroupAsync

> XblPresenceGetPresenceForSocialGroupAsync

# XblPresenceGetPresenceForSocialGroupAsync

Obtém informações de presença para um grupo específico de usuários.

## Sintaxe

```cpp theme={null}
HRESULT XblPresenceGetPresenceForSocialGroupAsync(  
         XblContextHandle xblContextHandle,  
         const char* socialGroupName,  
         uint64_t* socialGroupOwnerXuid,  
         XblPresenceQueryFilters* filters,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*xblContextHandle*   \_In\_\
Tipo: [XblContextHandle](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

Contexto do XBOX Live para o usuário local.

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

O nome do grupo de usuários para o qual obter a presença. Pode ser "Favorites" para recuperar informações sobre favoritos, "People" para recuperar informações sobre amigos mútuos e pessoas que um usuário segue, ou "Friends" para recuperar informações sobre amigos mútuos.

*socialGroupOwnerXuid*   \_In\_opt\_\
Tipo: uint64\_t\*

O usuário cujo grupo deve ser usado como destino. Se a entrada for nula, o usuário atual será usado.

*filters*   \_In\_opt\_\
Tipo: [XblPresenceQueryFilters\*](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters.md)

Estrutura de filtros opcional para filtrar os resultados.

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

O AsyncBlock para esta operação.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Para recuperar o resultado da chamada de XblPresenceGetPresenceForSocialGroupAsync, chame [XblPresenceGetPresenceForSocialGroupResult](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult.md). Para recuperar o tamanho de buffer necessário para armazenar os resultados da chamada de XblPresenceGetPresenceForSocialGroupAsync, chame [XblPresenceGetPresenceForSocialGroupResultCount](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount.md).

## Requisitos

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

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

## Confira também

[presence\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/presence_c_members.md)


## Related topics

- [XblPresenceGetPresenceForSocialGroupResult](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult.md)
- [XblPresenceGetPresenceForSocialGroupResultCount](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount.md)
- [XblPresenceQueryFilters](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters.md)
- [presence_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/presence_c_members.md)
- [Obtendo a presença de um usuário](https://docs.xbox.com/pt-BR/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)