Skip to main content

XblAchievementsGetAchievementsForTitleIdAsync

获取指定标题的玩家的成就的第一页。

语法

参数

xboxLiveContext   _In_
类型:XblContextHandle
使用 XblContextCreateHandle 创建的 XBOX Live 上下文句柄。 xboxUserId   _In_
类型:uint64_t
玩家的 XBOX 用户 ID。 titleId   _In_
类型:uint32_t
标题 ID。 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年8月24日