Skip to main content

XblAchievementsManagerGetAchievementsByState

获取玩家处于特定进度状态的成就列表。

语法

参数

xboxUserId   _In_
类型:uint64_t
玩家的 XBOX 用户 ID。 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年8月24日