XblUserStatisticsGetSingleUserStatisticsAsync

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

구문

HRESULT XblUserStatisticsGetSingleUserStatisticsAsync(  
         XblContextHandle xblContextHandle,  
         uint64_t xboxUserId,  
         const char* serviceConfigurationId,  
         const char** statisticNames,  
         size_t statisticNamesCount,  
         XAsyncBlock* async  
)  

매개 변수

xblContextHandle _In_
형식: XblContextHandle

로컬 사용자용 Xbox Live 컨텍스트입니다.

xboxUserId _In_
형식: uint64_t

통계를 가져올 플레이어의 Xbox 사용자 ID입니다.

serviceConfigurationId _In_z_
형식: char*

타이틀용 SCID(서비스 구성 ID)입니다. SCID는 대소문자를 구분하므로 파트너 센터에서 직접 붙여넣기하세요.

statisticNames _In_
형식: char**

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

statisticNamesCount _In_
형식: size_t

통계 이름의 수입니다.

async _In_
형식: XAsyncBlock*

이 작업에 대한 AsyncBlock입니다.

반환 값

형식: HRESULT

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

설명

결과를 가져오려면 완료 후 XblUserStatisticsGetSingleUserStatisticsResultSize 및 XblUserStatisticsGetSingleUserStatisticsResult를 호출합니다. 값이 있는 통계만 반환됩니다. 예를 들어 3개의 통계 이름을 요청하고, 이 중에서 2개만 값이 있으면, 2개 통계만 서비스로 반환됩니다.

이벤트 기반 통계를 사용하는 경우, 통계 이름은 각 통계의 통계 인스턴스와 일치합니다. 타이틀 관리 통계를 사용하는 경우 통계 이름은 각 통계의 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