Skip to main content

​
XblAchievementsManagerGetAchievements

获取玩家的所有成就列表。

​
语法

​
参数

xboxUserId   _In_
类型：uint64_t 玩家的 XBOX 用户 ID。 sortField   _In_
类型：XblAchievementOrderBy 用于对成就列表进行排序的字段。 sortOrder   _In_
类型：XblAchievementsManagerSortOrder 对成就列表进行排序的方向。 achievementsResult   _Outptr_result_maybenull_
类型：XblAchievementsManagerResultHandle* AchievementsManager API 调用结果的句柄。其他 API 使用此句柄获取与所调用 API 相匹配的成就对象。当不再需要该结果时，必须使用 XblAchievementsManagerResultCloseHandle 关闭句柄。

​
返回值

类型：HRESULT 此 API 操作的 HRESULT 返回代码。

​
备注

将 XblAchievementOrderBy::TitleId 传入 sortField 时，得到的结果与传入 XblAchievementOrderBy::DefaultOrder 相同，因为成就管理器所跟踪的所有成就都具有相同的 TitleId。

​
要求

头文件： achievements_manager_c.h 库： Microsoft.Xbox.Services.14x.GDK.C.lib

​
另请参阅

achievements_manager_c
最后修改于 2026年8月24日

相关主题

XblAchievementsManagerGetAchievementXBOX 成就管理器 API 概述XblAchievementsManagerGetAchievementsByStateXblAchievementsManagerResultGetAchievementsXblAchievementsManagerUpdateAchievement