> ## 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.

# XblAchievementsManagerUpdateAchievement

> XblAchievementsManagerUpdateAchievement

# XblAchievementsManagerUpdateAchievement

업적 진행률을 업데이트하고 업적 잠금을 해제할 수 있도록 허용합니다.

## 구문

```cpp theme={null}
HRESULT XblAchievementsManagerUpdateAchievement(  
         uint64_t xboxUserId,  
         const char* achievementId,  
         uint8_t currentProgess  
)  
```

### 매개 변수

*xboxUserId*   \_In\_\
형식: uint64\_t

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

*achievementId*   \_In\_\
형식: char\*

Dev Center에서 정의한 UTF-8 인코딩된 업적 ID입니다.

*currentProgess*   \_In\_\
형식: uint8\_t

진행률을 나타내는 업적의 완료 백분율입니다. 유효 값은 1에서 100까지입니다. 업적 잠금을 해제하려면 100으로 설정합니다. 진행률은 서버에서 전송된 가장 높은 값으로 설정됩니다.

### 반환값

형식: HRESULT

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

## 설명

[XblAchievementsManagerAddLocalUser](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanageraddlocaluser)로 Achievements Manager가 성공적으로 초기화되었다고 가정하면, 이 API는 PC와 XBOX 콘솔에서 오프라인 상태일 때도 작동합니다. 오프라인 업데이트는 타이틀이 실행 중이지 않더라도 연결이 다시 설정되면 시스템에 의해 게시됩니다. 작업 결과는 로컬에서 즉시 반영되지 않습니다. 업데이트가 반영되는 가장 빠른 시점은 다음 프레임의 DoWork 호출 이후입니다. 변경 사항이 반영되면 DoWork에서 반환되는 배열에는 이벤트 형식이 AchievementProgressUpdated인 [XblAchievementsManagerEvent](/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent)가 포함되며, 새로운 진행률로 인해 업적이 잠금 해제된 경우에는 형식이 AchievementUnlocked인 추가 이벤트도 포함될 수 있습니다. 업적이 이미 잠금 해제되었거나 진행률 값이 서버에서 캐시된 값보다 작거나 같은 경우 이 함수는 각각 E\_NOT\_VALID\_STATE 또는 E\_INVALIDARG를 반환합니다. 이 함수로는 타이틀 기반 업적만 업데이트할 수 있습니다. 이벤트 기반 업적은 이 함수로 업데이트할 수 없습니다.

## REST 호출

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

## 요구 사항

**헤더:** achievements\_manager\_c.h

**라이브러리:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 참고 항목

[achievements\_manager\_c](/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

- [XBOX Achievements Manager API 개요](/ko/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerAddLocalUser](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanageraddlocaluser.md)
- [XblAchievementsUpdateAchievementAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsManagerGetAchievement](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)
- [XblAchievementsManagerGetAchievements](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)