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

# XblUserStatisticsGetMultipleUserStatisticsAsync

> XblUserStatisticsGetMultipleUserStatisticsAsync

# XblUserStatisticsGetMultipleUserStatisticsAsync

取得多位使用者的統計資料。

## 語法

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

### 參數

*xblContextHandle*   \_In\_\
類型：[XblContextHandle](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本機使用者的 XBOX Live 內容。

*xboxUserIds*   \_In\_\
類型：uint64\_t\*

要取得統計資料的使用者 XBOX 使用者識別碼清單。

*xboxUserIdsCount*   \_In\_\
類型：size\_t

XBOX 使用者識別碼的數目。

*serviceConfigurationId*   \_In\_z\_\
類型：char\*

遊戲的服務設定識別碼 (SCID)。SCID 會區分大小寫，因此請直接從 Partner Center 貼上。

*statisticNames*   \_In\_\
類型：char\*\*

要查閱的統計資料名稱集合。

*statisticNamesCount*   \_In\_\
類型：size\_t

統計資料名稱的數目。

*async*   \_In\_\
類型：XAsyncBlock\*

此作業的 AsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

完成時呼叫 [XblUserStatisticsGetMultipleUserStatisticsResultSize](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresultsize) 和 [XblUserStatisticsGetMultipleUserStatisticsResult](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresult) 以取得結果。只會傳回具有值的統計資料。例如，如果您要求 3 個統計資料名稱，但只有 2 個具有值，服務只會傳回 2 個統計資料。

如果使用[以事件為基礎的統計資料](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview)，統計資料名稱會與每個統計資料的[統計資料執行個體](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview#defining-stat-instances)一致。如果使用[遊戲管理的統計資料](/zh-TW/services/xbox-services/player-data/stats-leaderboards/title-managed/live-stats-tm-overview)，統計資料名稱會與每個統計資料的識別碼一致。

## REST 呼叫

V1 POST /batch

## 需求

**標頭：** user\_statistics\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

- [XblUserStatisticsGetMultipleUserStatisticsResult](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresult.md)
- [XblUserStatisticsGetMultipleUserStatisticsResultSize](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresultsize.md)
- [取得事件型統計資料](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-getting-eb-stat.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsAsync](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsasync.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsResult](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsresult.md)