XblUserStatisticsGetMultipleUserStatisticsAsync

Article
2025-04-28

Get statistics for multiple users.

Syntax

HRESULT XblUserStatisticsGetMultipleUserStatisticsAsync(  
         XblContextHandle xblContextHandle,  
         uint64_t* xboxUserIds,  
         size_t xboxUserIdsCount,  
         const char* serviceConfigurationId,  
         const char** statisticNames,  
         size_t statisticNamesCount,  
         XAsyncBlock* async  
)

Parameters

xblContextHandle _In_
Type: XblContextHandle

Xbox live context for the local user.

xboxUserIds _In_
Type: uint64_t*

A list of the user Xbox user IDs to get stats for.

xboxUserIdsCount _In_
Type: size_t

The number of Xbox user IDs.

serviceConfigurationId _In_z_
Type: char*

The Service Configuration ID (SCID) for the title. The SCID is considered case sensitive so paste it directly from the Partner Center.

statisticNames _In_
Type: char**

A collection of statistic names to lookup.

statisticNamesCount _In_
Type: size_t

The number of statistic names.

async _In_
Type: XAsyncBlock*

The AsyncBlock for this operation.

Return value

Type: HRESULT

HRESULT return code for this API operation.

Remarks

Call XblUserStatisticsGetMultipleUserStatisticsResultSize and XblUserStatisticsGetMultipleUserStatisticsResult upon completion to get the result. Only statistics with values are returned. For example, if you ask for 3 statistic names and only 2 have values, only 2 statistics are returned by the service.

If using event-based Stats, statistic names will coincide with each stat's stat instance. If using title-managed Stats, statistic names will coincide with each stat's ID.

REST Call

V1 POST /batch

Requirements

Header: user_statistics_c.h

Library: Microsoft.Xbox.Services.14x.GDK.C.lib

Share via