Skip to main content

​
XblUserStatisticsGetSingleUserStatisticsAsync

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

​
Syntaxe

​
Paramètres

xblContextHandle   _In_
Type : XblContextHandle Contexte XBOX live de l’utilisateur local. xboxUserId   _In_
Type : uint64_t XBOX User ID du joueur dont vous souhaitez 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 depuis 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 de cette opération.

​
Valeur de retour

Type : HRESULT Code de retour HRESULT pour cette opération d’API.

​
Remarques

Appelez XblUserStatisticsGetSingleUserStatisticsResultSize et XblUserStatisticsGetSingleUserStatisticsResult une fois l’opération terminée pour obtenir le résultat. Seules les statistiques ayant des valeurs sont renvoyées. Par exemple, si vous demandez 3 noms de statistiques et que seuls 2 ont des valeurs, le service ne renvoie que 2 statistiques. Si vous utilisez des statistiques basées sur les événements, les noms de statistiques correspondent à l’instance de statistique de chaque statistique. Si vous utilisez des statistiques gérées par le titre, les noms de statistiques correspondent à l’ID de chaque statistique. Les statistiques demandées via cette API sont transformées en une liste délimitée par des virgules limitée à 260 caractères. Si vous recevez une erreur 400 lors de l’appel de cette méthode, essayez de demander moins de statistiques afin de réduire la longueur de cette chaîne transformée.

​
Appel REST

V1 GET /users/xuid()/scids//stats/,…,

​
Configuration requise

En-tête : user_statistics_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.lib

​
Voir aussi

user_statistics_c
Last modified on October 6, 2026