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

단일 사용자에 대해 지정된 통계를 가져옵니다.

## Syntax

```cpp theme={null}
HRESULT XblUserStatisticsGetSingleUserStatisticsAsync(  
         XblContextHandle xblContextHandle,  
         uint64_t xboxUserId,  
         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 컨텍스트입니다.

*xboxUserId*   \_In\_\
Type: uint64\_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

완료 시 결과를 얻으려면 [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 Call

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

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

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