> ## 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.

# PFGameSaveFilesUploadWithUiAsync

> 上传 PFGameSaveFilesGetFolder() 返回的文件夹中的所有文件和文件夹。必须先添加用户。在非 Windows 平台上，上传在游戏所在的同一进程中进行，并可能触发以下 UI 回调：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback。在 XBOX 和 Windows 平台上，上传在进程外完成，并由系统提供标准 UI。在 XBOX 和 Windows 平台上，调用此 API 是可选的，因为上传会在游戏未运行时自动进行。

上传 PFGameSaveFilesGetFolder() 返回的文件夹中的所有文件和文件夹。必须先添加用户。在非 Windows 平台上，上传在游戏所在的同一进程中进行，并可能触发以下 UI 回调：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback。在 XBOX 和 Windows 平台上，上传在进程外完成，并由系统提供标准 UI。在 XBOX 和 Windows 平台上，调用此 API 是可选的，因为上传会在游戏未运行时自动进行。

## 语法

```cpp theme={null}
HRESULT PFGameSaveFilesUploadWithUiAsync(  
    PFLocalUserHandle localUserHandle,  
    PFGameSaveFilesUploadOption option,  
    XAsyncBlock* async  
)  
```

### 参数

**`localUserHandle`**   PFLocalUserHandle

要上传其游戏存档文件和文件夹的本地用户。

**`option`**   [PFGameSaveFilesUploadOption](/zh-CN/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilesuploadoption)

上传文件和文件夹时要使用的选项。

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

用于轮询调用状态和获取调用结果的 XAsyncBlock。

### 返回值

类型：HRESULT

若要获取对 PFGameSaveFilesUploadWithUiAsync 的调用结果，请调用 PFGameSaveFilesUploadWithUiResult。

## 要求

**头文件：** PFGameSaveFiles.h

## 另请参阅

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


## Related topics

- [PFGameSaveFilesUploadWithUiResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiresult.md)
- [Game Saves UI 回调](/zh-CN/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [PFGameSaveFilesSetUiCallbacks](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [Game Saves 离线模式](/zh-CN/services/playfab/player-progression/game-saves/offline.md)
- [PFGameSaveFilesUiSyncFailedUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md)