Skip to main content

XblUserStatisticsGetSingleUserStatisticsAsync

获取单个用户的指定统计信息。

语法

参数

xblContextHandle   _In_
类型:XblContextHandle
本地用户的 XBOX Live 上下文。 xboxUserId   _In_
类型:uint64_t
要获取统计信息的玩家的 XBOX 用户 ID。 serviceConfigurationId   _In_z_
类型:char*
标题的服务配置 ID (SCID)。SCID 区分大小写,因此请直接从合作伙伴中心粘贴。 statisticNames   _In_
类型:char**
要查找的统计信息名称集合。 statisticNamesCount   _In_
类型:size_t
统计信息名称的数量。 async   _In_
类型:XAsyncBlock*
此操作的 AsyncBlock。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

完成后调用 XblUserStatisticsGetSingleUserStatisticsResultSizeXblUserStatisticsGetSingleUserStatisticsResult 以获取结果。仅返回具有值的统计信息。例如,如果请求 3 个统计信息名称但只有 2 个具有值,则服务只返回 2 个统计信息。 如果使用基于事件的统计信息,统计信息名称将与每个统计信息的统计信息实例一致。如果使用基于标题托管的统计信息,统计信息名称将与每个统计信息的 ID 一致。 通过此 API 请求的统计信息将转换为逗号分隔的列表,字符限制为 260。如果在调用此方法时收到 400 错误,请尝试请求更少的统计信息以缩短转换后字符串的长度。

REST 调用

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

要求

头文件: user_statistics_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

user_statistics_c
最后修改于 2026年8月24日