> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFGameSaveFilesAddUserWithUiAsync

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

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

## 语法

```cpp theme={null}
HRESULT PFGameSaveFilesAddUserWithUiAsync(  
    PFLocalUserHandle localUserHandle,  
    PFGameSaveFilesAddUserOptions options,  
    XAsyncBlock* async  
)  
```

### 参数

**`localUserHandle`**   PFLocalUserHandle

要添加的本地用户。

**`options`**   [PFGameSaveFilesAddUserOptions](/zh-CN/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilesadduseroptions)

添加用户时使用的选项。

**`async`**   XAsyncBlock\*<br />*Inout*

用于轮询调用状态和检索调用结果的 XAsyncBlock。

### 返回值

类型：HRESULT

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

## 要求

**头文件：** PFGameSaveFiles.h

## 另请参阅

[PFGameSaveFiles 成员](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

- [PFGameSaveFilesAddUserWithUiResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [Game Saves UI 回调](/zh-CN/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [PFGameSaveFilesUiSyncFailedUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md)
- [PFGameSaveFilesSetUiCallbacks](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [PFGameSaveFilesIsConnectedToCloud](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud.md)