> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblAchievementsUpdateAchievementForTitleIdAsync

> XblAchievementsUpdateAchievementForTitleIdAsync

# XblAchievementsUpdateAchievementForTitleIdAsync

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

## Syntax

```cpp theme={null}
HRESULT XblAchievementsUpdateAchievementForTitleIdAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         const uint32_t titleId,  
         const char* serviceConfigurationId,  
         const char* achievementId,  
         uint32_t percentComplete,  
         XAsyncBlock* async  
)  
```

### Parameters

*xboxLiveContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/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](/reference/system/xasync/functions/xasyncgetstatus)를 호출하여 얻을 수 있습니다. 예기치 않게 실패하는 경우, SCID는 대/소문자를 구분하므로 XblInitArgs에 올바르게 지정되어 있는지 확인하십시오.

## REST Call

V2 POST /users/xuid({xuid})/achievements/{scid}/update

## Requirements

**Header:** achievements\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

[achievements\_c](/reference/live/xsapi-c/achievements_c/achievements_c_members)


## Related topics

- [타이틀 관리형 업적 업데이트](/ko/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)
- [XblAchievementsUpdateAchievementAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblAchievementsGetAchievementsForTitleIdResult](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidresult.md)
- [타이틀 관리형 업적 가져오기](/ko/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-get-achievements.md)