通过

XblAchievementsGetAchievementsForTitleIdAsync

  • 项目

获取指定游戏的玩家的第一页成就。

语法

HRESULT XblAchievementsGetAchievementsForTitleIdAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         uint32_t titleId,  
         XblAchievementType type,  
         bool unlockedOnly,  
         XblAchievementOrderBy orderBy,  
         uint32_t skipItems,  
         uint32_t maxItems,  
         XAsyncBlock* async  
)

参数

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({xuid})/achievements

要求

头文件：achievements_c.h

图书馆： Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

achievements_c