XblAchievementsUpdateAchievementAsync

允許更新成就進度及解除鎖定成就。

語法

HRESULT XblAchievementsUpdateAchievementAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         const char* achievementId,  
         uint32_t percentComplete,  
         XAsyncBlock* async  
)  

參數

xboxLiveContext   _In_
類型：XblContextHandle 使用 XblContextCreateHandle 建立的 Xbox Live 內容控制代碼。 xboxUserId   _In_
類型：uint64_t 玩家的 XBOX 使用者識別碼。 achievementId   _In_z_
類型：char* 由 XDP 或開發人員中心定義之成就的 UTF-8 編碼識別碼。 percentComplete   _In_
類型：uint32_t 表示進度的成就完成百分比。有效值為 1 到 100。設定為 100 即可解除鎖定成就。伺服器會將進度設定為所傳送的最高值 async   _In_
類型：XAsyncBlock* 呼叫端配置的 AsyncBlock。

傳回值

類型：HRESULT 此 API 作業的 HRESULT 傳回碼。

備註

即使在 PC 和 XBOX One 上離線時，此 API 也能運作。重新建立連線時，即使遊戲未在執行中，系統也會發佈離線更新。在 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

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XblAchievementsUpdateAchievementAsync

XblAchievementsUpdateAchievementAsync

語法

參數

傳回值

備註

REST 呼叫

需求

另請參閱

​XblAchievementsUpdateAchievementAsync

​語法

​參數

​傳回值

​備註

​REST 呼叫

​需求

​另請參閱

XblAchievementsUpdateAchievementAsync

語法

參數

傳回值

備註

REST 呼叫

需求

另請參閱