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

# XGameSaveFiles（API 内容）

> XGameSaveFiles

# XGameSaveFiles

XGameSaveFiles 是一组 API，用于代表用户/游戏读取和写入数据，这些数据可以在游戏会话之间持久保存，并且可以与云无缝同步以在多个设备之间使用。

这是 XGameSave API 的一个变体，设计为在检索游戏保存路径后与基于简单文件的访问一起使用。

## 函数

| 函数 | 说明 |
| - | - |
| [XGameSaveFilesGetFolderWithUiAsync](https://docs.xbox.com/zh-CN/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md) | 返回可用于包含目录和文件以进行存储的文件夹。 |
| [XGameSaveFilesGetFolderWithUiResult](https://docs.xbox.com/zh-CN/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiresult.md) | 返回可用于包含目录和文件以存储在云中的文件夹。 |
| [XGameSaveFilesGetRemainingQuota](https://docs.xbox.com/zh-CN/reference/system/xgamesavefiles/functions/xgamesavefilesgetremainingquota.md) | 返回可使用 XGameSaveFiles API 存储保存数据的数据量。 |

## 错误代码

XGameSaveFiles 与 XGameSave API 共用错误代码。可能会返回以下代码。完整列表请参阅[错误代码](https://docs.xbox.com/zh-CN/reference/errorcodes.md)。

| 代码 | 值 | 说明 |
| - | - | - |
| E\_GS\_PROVIDER\_MISMATCH | 0x8083000F | 游戏混合使用 XGameSave 和 XGameSaveFiles 调用，这是不支持的。 |

## 概念性文档

* [游戏保存概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-overview.md)
* [XGameSaveFiles 指南](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/xgamesavefiles.md)
* [游戏保存工具](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-tools.md)

## 另请参阅

[系统 API 参考](https://docs.xbox.com/zh-CN/reference/system/gc-reference-system-toc.md)


## Related topics

- [XGameSaveFiles API 概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/xgamesavefiles.md)
- [游戏存档调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)
- [游戏存档存储系统](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-storage-systems.md)
- [游戏存档工具](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-tools.md)
- [XGameSave Wrapper 参考（API 内容）](https://docs.xbox.com/zh-CN/reference/system/Wrappers/xgamesave_wrapper_members.md)