Skip to main content

​
XblUserStatisticsGetSingleUserStatisticsAsync

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

​
Syntax

​
Parameters

xblContextHandle   _In_
Type: 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 및 XblUserStatisticsGetSingleUserStatisticsResult를 호출합니다. 값이 있는 통계만 반환됩니다. 예를 들어 3개의 통계 이름을 요청하고 그 중 2개에만 값이 있으면 서비스에서 2개의 통계만 반환합니다. 이벤트 기반 통계를 사용하는 경우 통계 이름은 각 통계의 통계 인스턴스와 일치합니다. 타이틀 관리 통계를 사용하는 경우 통계 이름은 각 통계의 ID와 일치합니다. 이 API를 통해 요청된 통계는 260자 제한이 있는 쉼표로 구분된 목록으로 변환됩니다. 이 메서드를 호출할 때 400 오류가 수신되는 경우, 변환된 문자열의 길이를 줄이기 위해 더 적은 수의 통계를 요청해 보세요.

​
REST Call

V1 GET /users/xuid()/scids//stats/,…,

​
Requirements

Header: user_statistics_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

​
See also

user_statistics_c
마지막 수정일 2026년 8월 24일

관련 항목

XblUserStatisticsGetSingleUserStatisticsResultXblUserStatisticsGetSingleUserStatisticResultSizeXblUserStatisticsGetSingleUserStatisticsResultSizeXblUserStatisticsGetSingleUserStatisticAsyncXblUserStatisticsGetSingleUserStatisticResult