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日