跳轉到主要內容

XblAchievementsGetAchievementsForTitleIdAsync

取得指定遊戲之玩家成就的第一頁。

語法

參數

xboxLiveContext   _In_
類型:XblContextHandle
使用 XblContextCreateHandle 建立的 Xbox Live 內容控制代碼。 xboxUserId   _In_
類型:uint64_t
玩家的 XBOX 使用者識別碼。 titleId   _In_
類型:uint32_t
遊戲識別碼。 type   _In_
類型:XblAchievementType
要擷取的成就類型。 unlockedOnly   _In_
類型:bool
指出是否只傳回已解除鎖定的成就。 orderBy   _In_
類型:XblAchievementOrderBy
控制成就清單的排序方式。 skipItems   _In_
類型:uint32_t
要略過的成就數目。 maxItems   _In_
類型:uint32_t
結果可包含的成就數目上限。傳遞 0 以嘗試擷取所有項目。 async   _In_
類型:XAsyncBlock*
呼叫端配置的 AsyncBlock。

傳回值

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

備註

若要取得結果,請在 AsyncBlock 回呼內或在 AsyncBlock 完成後呼叫 XblAchievementsGetAchievementsForTitleIdResult。

REST 呼叫

V2 GET /users/xuid()/achievements

需求

標頭: achievements_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

achievements_c
最後修改於 2026年10月6日