Skip to main content

XblAchievementsUpdateAchievementAsync

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

構文

パラメーター

xboxLiveContext   _In_
型: 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 を呼び出すことで取得できます。実績が既にアンロックされているか、進捗値がサーバーに現在記録されている値以下の場合、コールバック内の XAsyncGetStatus() は HTTP_E_STATUS_NOT_MODIFIED (0x80190130L) を返します。

REST 呼び出し

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

要件

ヘッダー: achievements_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

achievements_c
最終更新日 2026年8月24日