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

# XblAchievementsUpdateAchievementAsync

> XblAchievementsUpdateAchievementAsync

# XblAchievementsUpdateAchievementAsync

実績の進捗を更新し、実績のアンロックを可能にします。

## 構文

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

### パラメーター

*xboxLiveContext*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XblContextCreateHandle で作成された XBOX live コンテキスト ハンドル。

*xboxUserId*   \_In\_\
型: uint64\_t

プレイヤーの XBOX ユーザー ID。

*achievementId*   \_In\_z\_\
型: char\*

XDP または Dev Center で定義された、UTF-8 エンコードされた実績 ID。

*percentComplete*   \_In\_\
型: uint32\_t

進捗を示す実績の完了率。有効な値は 1 から 100 までです。実績をアンロックするには 100 に設定します。進捗はサーバーによって、送信された最大の値に設定されます。

*async*   \_In\_\
型: XAsyncBlock\*

呼び出し元が割り当てた AsyncBlock。

### 戻り値

型: HRESULT

この API 操作の HRESULT 戻り値コード。

## 解説

この API は PC および XBOX One がオフラインの場合でも動作します。オフライン更新は、タイトルが実行されていない場合でも、接続が再確立されたときにシステムによって送信されます。非同期操作の結果は、AsyncBlock コールバック内、または AsyncBlock 完了後に [XAsyncGetStatus](/reference/system/xasync/functions/xasyncgetstatus) を呼び出すことで取得できます。実績が既にアンロックされているか、進捗値がサーバーに現在記録されている値以下の場合、コールバック内の XAsyncGetStatus() は HTTP\_E\_STATUS\_NOT\_MODIFIED (0x80190130L) を返します。

## REST 呼び出し

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

## 要件

**ヘッダー:** achievements\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

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


## Related topics

- [GDK 向け Unity C# API ラッパー](/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [タイトル マネージド実績の更新](/ja-jp/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)
- [XblAchievementsManagerAddLocalUser](/ja-jp/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanageraddlocaluser.md)
- [Stats と Achievements](/ja-jp/build/steam-porting-guide/features/stats-and-achievements.md)
- [XblAchievementsUpdateAchievementForTitleIdAsync](/ja-jp/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementfortitleidasync.md)