跳转到主要内容
将用户添加到游戏存档系统。此操作会根据需要从云下载存档状态,并可能触发以下 UI 回调:PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。有关更多详细信息,请参阅 PFGameSaveFilesSetUiCallbacks。必须先调用 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上,系统会提供内置 UI。

语法

参数

localUserHandle PFLocalUserHandle 要添加的本地用户。 options PFGameSaveFilesAddUserOptions 添加用户时使用的选项。 async XAsyncBlock*
Inout
用于轮询调用状态和检索调用结果的 XAsyncBlock。

返回值

类型:HRESULT 若要检索 PFGameSaveFilesAddUserWithUiAsync 调用的结果,请调用 PFGameSaveFilesAddUserWithUiResult。此调用完成后,可以调用 PFGameSaveFilesGetFolder 来获取此用户的游戏存档文件和文件夹的根文件夹。根文件夹中的所有文件和子文件夹都将与云同步。每个用户只能调用一次此函数,通常在显示游戏主菜单之前调用。若要为同一用户重新触发下载,请先调用 PFGameSaveFilesUninitializeAsync 并等待其完成

要求

头文件: PFGameSaveFiles.h

另请参阅

PFGameSaveFiles 成员
最后修改于 2026年10月6日