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

# XGameSaveFilesGetFolderWithUiAsync

> XGameSaveFilesGetFolderWithUiAsync

# XGameSaveFilesGetFolderWithUiAsync

返回可用于包含目录和文件以进行存储的文件夹。

## 语法

```cpp theme={null}
HRESULT XGameSaveFilesGetFolderWithUiAsync(
  XUserHandle requestingUser,
  const char * configurationId,
  XAsyncBlock * async
)
```

### 参数

`requestingUser`\
类型：*In* XUserHandle

XBOX Live 用户的句柄。

`configurationId`\
类型：*In\_z* const char \*

服务配置 ID (SCID)。

`async`\
类型：*In* XAsyncBlock \*

包含异步调用的信息。

### 返回值

类型：HRESULT

函数结果。

### 备注

游戏不能混合使用 XGameSaveFiles 和 XGameSave。游戏必须选择要使用的云保存系统。
如果游戏正在使用 XGameSaveFiles 且随后调用 XGameSaveInitializeProvider，则将出错
并返回 E\_GS\_PROVIDER\_MISMATCH。同样，如果游戏正在使用 XGameSave 且随后调用 XGameSaveFilesGetFolderWithUiAsync，
也将出错并返回 E\_GS\_PROVIDER\_MISMATCH。

当游戏恢复时，开发者应调用 **XGameSaveFilesGetFolderWithUiAsync**，以确保保存数据
是完全最新的。

## 要求

**标头：** XGameSaveFiles.h

## 概念性文档

* [调试游戏保存](/build/core-features/common/game-save/game-saves-debugging)
* [游戏保存工具](/build/core-features/common/game-save/game-saves-tools)
* [游戏保存演练和示例](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples)
* [在游戏中实现云保存](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-services/e2e-cloud-saves)

## 另请参阅

[XGameSaveFiles 成员](/reference/system/xgamesavefiles/xgamesavefiles_members)\
[XGameSaveFiles 概述](/build/core-features/common/game-save/xgamesavefiles)


## Related topics

- [XGameSaveFiles](/zh-CN/reference/system/xgamesavefiles/xgamesavefiles_members.md)
- [游戏存档演练与示例](/zh-CN/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [游戏存档调试](/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)
- [游戏存档工具](/zh-CN/build/core-features/common/game-save/game-saves-tools.md)
- [XGameSaveFiles API 概述](/zh-CN/build/core-features/common/game-save/xgamesavefiles.md)