Skip to main content

​
XblAchievementsUpdateAchievementAsync

도전 과제 진행률을 업데이트하고 도전 과제를 잠금 해제할 수 있도록 합니다.

​
Syntax

​
Parameters

xboxLiveContext   _In_
Type: XblContextHandle XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다. xboxUserId   _In_
Type: uint64_t 플레이어의 XBOX User ID입니다. achievementId   _In_z_
Type: char* XDP 또는 Dev Center에서 정의된 UTF-8 인코딩된 도전 과제 ID입니다. percentComplete   _In_
Type: uint32_t 진행률을 나타내는 도전 과제의 완료율입니다. 유효한 값은 1에서 100 사이입니다. 도전 과제를 잠금 해제하려면 100으로 설정합니다. 진행률은 서버에서 전송된 가장 높은 값으로 설정됩니다. async   _In_
Type: XAsyncBlock* 호출자가 할당한 AsyncBlock입니다.

​
Return value

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

​
Remarks

이 API는 PC 및 XBOX One에서 오프라인 상태일 때도 작동합니다. 오프라인 업데이트는 타이틀이 실행 중이 아니더라도 연결이 다시 설정되면 시스템에서 게시합니다. 비동기 작업의 결과는 AsyncBlock 콜백 내부 또는 AsyncBlock이 완료된 후에 XAsyncGetStatus를 호출하여 얻을 수 있습니다. 도전 과제가 이미 잠금 해제되었거나 진행률 값이 현재 서버에 기록된 값 이하인 경우, 콜백 내부의 XAsyncGetStatus()는 HTTP_E_STATUS_NOT_MODIFIED(0x80190130L)를 반환합니다.

​
REST Call

V2 POST /users/xuid()/achievements//update

​
Requirements

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

​
See also

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

관련 항목

GDK용 Unity C# API 래퍼타이틀 관리형 업적 업데이트XblAchievementsManagerAddLocalUser통계와 업적XblAchievementsUpdateAchievementForTitleIdAsync