> ## 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-CA/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexte XBOX Live de l'utilisateur local.

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

Le nom du groupe d'utilisateurs pour lequel obtenir la présence. 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\*

L'utilisateur dont le groupe doit être ciblé. Si l'entrée est null, l'utilisateur actuel sera utilisé.

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

Structure de filtres facultative pour filtrer les résultats.

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

L'AsyncBlock pour 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-CA/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult). Pour récupérer la taille de mémoire tampon requise pour contenir les résultats de l'appel à XblPresenceGetPresenceForSocialGroupAsync, appelez [XblPresenceGetPresenceForSocialGroupResultCount](/fr-CA/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-CA/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)
- [XblPresenceGetPresenceForSocialGroupResultCount](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount.md)
- [Getting a user's Presence](/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceQueryFilters](/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters.md)