Skip to main content

XblAchievementsGetAchievementsForTitleIdAsync

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

Syntax

Parameters

xboxLiveContext   _In_
Type: XblContextHandle
XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다. xboxUserId   _In_
Type: uint64_t
플레이어의 XBOX User ID입니다. titleId   _In_
Type: uint32_t
타이틀 ID입니다. type   _In_
Type: XblAchievementType
검색할 도전 과제 형식입니다. unlockedOnly   _In_
Type: bool
잠금 해제된 도전 과제만 반환할지 여부를 나타냅니다. orderBy   _In_
Type: XblAchievementOrderBy
도전 과제 목록의 정렬 방식을 제어합니다. skipItems   _In_
Type: uint32_t
건너뛸 도전 과제 수입니다. maxItems   _In_
Type: uint32_t
결과에 포함될 수 있는 최대 도전 과제 수입니다. 모든 항목을 검색하려면 0을 전달합니다. async   _In_
Type: XAsyncBlock*
호출자가 할당한 AsyncBlock입니다.

Return value

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

Remarks

결과를 얻으려면 AsyncBlock 콜백 내부 또는 AsyncBlock이 완료된 후에 XblAchievementsGetAchievementsForTitleIdResult를 호출합니다.

REST Call

V2 GET /users/xuid()/achievements

Requirements

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

See also

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