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

여러 사용자에 대한 통계를 가져옵니다.

## Syntax

```cpp theme={null}
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](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

로컬 사용자에 대한 XBOX live 컨텍스트입니다.

*xboxUserIds*   \_In\_\
Type: uint64\_t\*

통계를 가져올 사용자의 XBOX user ID 목록입니다.

*xboxUserIdsCount*   \_In\_\
Type: size\_t

XBOX user ID의 수입니다.

*serviceConfigurationId*   \_In\_z\_\
Type: char\*

타이틀의 Service Configuration ID(SCID)입니다. SCID는 대/소문자를 구분하는 것으로 간주되므로 Partner Center에서 직접 붙여넣습니다.

*statisticNames*   \_In\_\
Type: char\*\*

조회할 통계 이름의 컬렉션입니다.

*statisticNamesCount*   \_In\_\
Type: size\_t

통계 이름의 수입니다.

*async*   \_In\_\
Type: XAsyncBlock\*

이 작업에 대한 AsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

## Remarks

완료 시 결과를 얻으려면 [XblUserStatisticsGetMultipleUserStatisticsResultSize](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresultsize) 및 [XblUserStatisticsGetMultipleUserStatisticsResult](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresult)를 호출합니다. 값이 있는 통계만 반환됩니다. 예를 들어 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와 일치합니다.

## REST Call

V1 POST /batch

## Requirements

**Header:** user\_statistics\_c.h

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

## See also

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


## Related topics

- [XblUserStatisticsGetMultipleUserStatisticsResult](/ko/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresult.md)
- [XblUserStatisticsGetMultipleUserStatisticsResultSize](/ko/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsresultsize.md)
- [이벤트 기반 통계 가져오기](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-getting-eb-stat.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsAsync](/ko/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsasync.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsResult](/ko/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsresult.md)