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

# XblUserStatisticsGetSingleUserStatisticsAsync

> XblUserStatisticsGetSingleUserStatisticsAsync

# XblUserStatisticsGetSingleUserStatisticsAsync

Obtient les statistiques spécifiées pour un seul utilisateur.

## Syntaxe

```cpp theme={null}
HRESULT XblUserStatisticsGetSingleUserStatisticsAsync(  
         XblContextHandle xblContextHandle,  
         uint64_t xboxUserId,  
         const char* serviceConfigurationId,  
         const char** statisticNames,  
         size_t statisticNamesCount,  
         XAsyncBlock* async  
)  
```

### Paramètres

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

Contexte XBOX Live pour l'utilisateur local.

*xboxUserId*   \_In\_\
Type : uint64\_t

ID d'utilisateur XBOX du joueur pour lequel obtenir les statistiques.

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

ID de configuration de service (SCID) du titre. Le SCID respecte la casse; collez-le donc directement à partir de Partner Center.

*statisticNames*   \_In\_\
Type : char\*\*

Collection de noms de statistiques à rechercher.

*statisticNamesCount*   \_In\_\
Type : size\_t

Nombre de noms de statistiques.

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

AsyncBlock pour cette opération.

### Valeur de retour

Type : HRESULT

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

## Remarques

Appelez [XblUserStatisticsGetSingleUserStatisticsResultSize](/fr-CA/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresultsize) et [XblUserStatisticsGetSingleUserStatisticsResult](/fr-CA/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresult) une fois l'opération terminée pour obtenir le résultat. Seules les statistiques ayant des valeurs sont retournées. Par exemple, si vous demandez 3 noms de statistiques et que seulement 2 ont des valeurs, le service ne retourne que 2 statistiques.

Si vous utilisez des [statistiques basées sur les événements](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview), les noms de statistiques correspondent à l'[instance de statistique](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview#defining-stat-instances) de chaque statistique. Si vous utilisez des [statistiques gérées par le titre](/fr-CA/services/xbox-services/player-data/stats-leaderboards/title-managed/live-stats-tm-overview), les noms de statistiques correspondent à l'ID de chaque statistique.

Les statistiques demandées au moyen de cette API sont transformées en une liste délimitée par des virgules limitée à 260 caractères.  Si une erreur 400 est reçue lors de l'appel de cette méthode, essayez de demander moins de statistiques pour raccourcir la longueur de cette chaîne transformée.

## Appel REST

V1 GET /users/xuid({xuid})/scids/{scid}/stats/{statname1},...,{statnameN}

## Configuration requise

**En-tête :** user\_statistics\_c.h

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

## Voir aussi

[user\_statistics\_c](/fr-CA/reference/live/xsapi-c/user_statistics_c/user_statistics_c_members)


## Related topics

- [XblUserStatisticsGetSingleUserStatisticsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)
- [XblUserStatisticsGetSingleUserStatisticsResult](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresult.md)