Skip to main content

XblAchievementsManagerGetAchievementsByState

取得玩家處於特定進度狀態的成就清單。

語法

參數

xboxUserId   _In_
類型:uint64_t
玩家的 XBOX 使用者識別碼。 sortField   _In_
類型:XblAchievementOrderBy
用來排序成就清單的欄位。TitleId 的行為會與 DefaultOrder 相同,因為 AchievementsManager 一次只處理一個遊戲。 sortOrder   _In_
類型:XblAchievementsManagerSortOrder
成就清單的排序方向。 achievementState   _In_
類型:XblAchievementProgressState
要包含在結果中的成就狀態。 achievementsResult   _Outptr_result_maybenull_
類型:XblAchievementsManagerResultHandle*
AchievementsManager API 呼叫結果的控制代碼。其他 API 會使用此控制代碼來取得符合所呼叫 API 的成就物件。不再需要結果時,必須使用 XblAchievementsManagerResultCloseHandle 關閉此控制代碼。

傳回值

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

需求

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

另請參閱

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