Skip to main content

XblAchievementsUpdateAchievementForTitleIdAsync

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

Syntax

Parameters

xboxLiveContext   _In_
Type: XblContextHandle
XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다. xboxUserId   _In_
Type: uint64_t
플레이어의 XBOX User ID입니다. titleId   _In_
Type: uint32_t
타이틀 ID입니다. serviceConfigurationId   _In_z_
Type: char*
타이틀의 Service Configuration ID(SCID)입니다. SCID는 대/소문자를 구분하는 것으로 간주되므로 Partner Center에서 직접 붙여넣습니다. 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를 호출하여 얻을 수 있습니다. 예기치 않게 실패하는 경우, SCID는 대/소문자를 구분하므로 XblInitArgs에 올바르게 지정되어 있는지 확인하십시오.

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일