通过

XblAchievementsGetAchievementAsync

  • 项目

获得具有特定成就 ID 的玩家的成就。

语法

HRESULT XblAchievementsGetAchievementAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         const char* serviceConfigurationId,  
         const char* achievementId,  
         XAsyncBlock* async  
)

参数

xboxLiveContext _In_
类型：XblContextHandle

使用 XblContextCreateHandle 创建的 xbox live 上下文句柄。

xboxUserId _In_
类型：uint64_t

玩家的 Xbox 用户 ID。

serviceConfigurationId _In_z_
类型：char*

游戏的服务配置 ID (SCID)。 因为将 SCID 视为区分大小写，所以可直接从合作伙伴中心粘贴它。

achievementId _In_z_
类型：char*

成就的 UTF-8 编码的唯一标识符，由 XDP 或开发者中心定义。

async _In_
类型：XAsyncBlock*

调用方分配的 AsyncBlock。

返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

备注

要获得结果，请在 AsyncBlock 回调中或 AsyncBlock 完成后调用 XblAchievementsGetAchievementResult。

REST 调用

V2 GET /users/xuid({xuid})/achievements/{scid}/{achievementId}

要求

头文件：achievements_c.h

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

另请参阅

achievements_c