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

# XblPresenceGetPresenceForSocialGroupAsync

> XblPresenceGetPresenceForSocialGroupAsync

# XblPresenceGetPresenceForSocialGroupAsync

Obtient les informations de présence pour un groupe d'utilisateurs spécifique.

## Syntaxe

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

### Paramètres

*xblContextHandle*   \_In\_\
Type : [XblContextHandle](/fr/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexte XBOX Live de l'utilisateur local.

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

Nom du groupe d'utilisateurs dont la présence doit être obtenue. Il peut s'agir de "Favorites" pour récupérer des informations sur les favoris, de "People" pour récupérer des informations sur les amis mutuels et les personnes suivies par un utilisateur, ou de "Friends" pour récupérer des informations sur les amis mutuels.

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

Utilisateur dont le groupe doit être ciblé. Si la valeur d'entrée est null, l'utilisateur actuel est utilisé.

*filters*   \_In\_opt\_\
Type : [XblPresenceQueryFilters\*](/fr/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters)

Structure de filtres facultative permettant de filtrer les résultats.

*async*   \_In\_\
Type : XAsyncBlock\*

AsyncBlock de cette opération.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT pour cette opération d'API.

## Remarques

Pour récupérer le résultat de l'appel à XblPresenceGetPresenceForSocialGroupAsync, appelez [XblPresenceGetPresenceForSocialGroupResult](/fr/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult). Pour récupérer la taille de mémoire tampon nécessaire pour contenir les résultats de l'appel à XblPresenceGetPresenceForSocialGroupAsync, appelez [XblPresenceGetPresenceForSocialGroupResultCount](/fr/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount).

## Configuration requise

**En-tête :** presence\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

[presence\_c](/fr/reference/live/xsapi-c/presence_c/presence_c_members)


## Related topics

- [XblPresenceGetPresenceForSocialGroupAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [XblPresenceGetPresenceForSocialGroupResult](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult.md)