Skip to main content

XblAchievementsManagerAddLocalUser

初始化成就管理器,并为用户生成本地成就缓存。

语法

参数

user   _In_
类型:XblUserHandle
用于获取成就的 XBOX Live 用户。 queue   _In_opt_
类型:XTaskQueueHandle
用于此用户后台操作的队列(可选)。

返回值

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

备注

由于 XblAchievementsManagerAddLocalUser 需要 Internet 连接才能正确跟踪用户信息,因此仅应在连接到 Internet 时调用它。使用 XNetworkingRegisterConnectivityHintChanged 是检查连接情况的一种好方法。 如果成就管理器未初始化,对 XblAchievementsManagerUpdateAchievement 的调用将失败。在这种情况下,应当在满足成就条件时改为调用 XblAchievementsUpdateAchievementAsync,以确保仍能跟踪进度。以下示例说明如何实现该逻辑:

要求

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

另请参阅

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