跳轉到主要內容

XblAchievementsManagerAddLocalUser

初始化 Achievements Manager,並為使用者產生成就的本機快取。

語法

參數

user   _In_
類型:XblUserHandle
要擷取其成就的 XBOX Live 使用者。 queue   _In_opt_
類型:XTaskQueueHandle
用於此使用者背景作業的佇列 (選用)。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

備註

由於 XblAchievementsManagerAddLocalUser 需要網際網路連線才能正確追蹤使用者資訊,因此應僅在連線至網際網路時呼叫。使用 XNetworkingRegisterConnectivityHintChanged 是檢查連線的好方法。 如果 Achievements Manager 未初始化,對 XblAchievementsManagerUpdateAchievement 的呼叫將會失敗。在此情況下,應在達成成就條件時改為呼叫 XblAchievementsUpdateAchievementAsync,以確保仍會追蹤進度。以下是實作方式的範例:

需求

標頭: achievements_manager_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

achievements_manager_c
最後修改於 2026年10月6日