다음을 통해 공유


XblAchievementsGetAchievementsForTitleIdAsync

지정된 타이틀의 플레이어에 대한 도전 과제의 첫 번째 페이지를 가져옵니다.

구문

HRESULT XblAchievementsGetAchievementsForTitleIdAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         uint32_t titleId,  
         XblAchievementType type,  
         bool unlockedOnly,  
         XblAchievementOrderBy orderBy,  
         uint32_t skipItems,  
         uint32_t maxItems,  
         XAsyncBlock* async  
)  

매개 변수

xboxLiveContext _In_
형식: XblContextHandle

XblContextCreateHandle로 생성된 Xbox Live 컨텍스트 핸들입니다.

xboxUserId _In_
형식: uint64_t

플레이어의 Xbox 사용자 ID입니다.

titleId _In_
형식: uint32_t

타이틀 ID입니다.

type _In_
형식: XblAchievementType

검색할 도전 과제 형식입니다.

unlockedOnly _In_
형식: bool

잠금 해제된 도전 과제만 반환할지 여부를 나타냅니다.

orderBy _In_
형식: XblAchievementOrderBy

도전 과제 목록이 정렬되는 방법을 제어합니다.

skipItems _In_
형식: uint32_t

건너뛸 도전 과제 수입니다.

maxItems _In_
형식: uint32_t

결과에 포함될 수 있는 도전 과제 최대 개수입니다. 모든 항목을 검색하려면 0을 전달합니다.

async _In_
형식: XAsyncBlock*

호출자가 할당한 AsyncBlock입니다.

반환 값

형식: HRESULT

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

설명

결과를 가져오려면 AsyncBlock 콜백 내에서 또는 AsyncBlock이 완료된 후에 XblAchievementsGetAchievementsForTitleIdResult를 호출합니다.

REST 호출

V2 GET /users/xuid({xuid})/achievements

요구 사항

헤더: achievements_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

achievements_c