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

単一のユーザーに対して指定された統計を取得します。

## 構文

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

### パラメーター

*xblContextHandle*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/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 戻り値コード。

## 解説

完了時に、結果を取得するために [XblUserStatisticsGetSingleUserStatisticsResultSize](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresultsize) と [XblUserStatisticsGetSingleUserStatisticsResult](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresult) を呼び出します。値を持つ統計のみが返されます。たとえば、3 つの統計名を要求して 2 つのみに値がある場合、サービスから返される統計は 2 つのみです。

[イベント ベースの統計](/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview)を使用している場合、統計名は各統計の[統計インスタンス](/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview#defining-stat-instances)と一致します。[タイトル管理の統計](/services/xbox-services/player-data/stats-leaderboards/title-managed/live-stats-tm-overview)を使用している場合、統計名は各統計の ID と一致します。

この API を通じて要求される統計はカンマ区切りのリストに変換され、260 文字の制限があります。このメソッドの呼び出し時に 400 エラーが返される場合は、要求する統計を減らして、変換後の文字列の長さを短くしてください。

## REST 呼び出し

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

## 要件

**ヘッダー:** user\_statistics\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

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


## Related topics

- [XblUserStatisticsGetSingleUserStatisticsResult](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresult.md)
- [XblUserStatisticsGetSingleUserStatisticsResultSize](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresultsize.md)
- [XblUserStatisticsGetSingleUserStatisticResultSize](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticresultsize.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)
- [XblUserStatisticsGetSingleUserStatisticResult](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticresult.md)