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

# XGameSaveFiles

> XGameSaveFiles

# XGameSaveFiles

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

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

## 函数

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

## 错误代码

XGameSaveFiles 与 XGameSave API 共用错误代码。可能会返回以下代码。完整列表请参阅[错误代码](/reference/errorcodes)。

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

## 概念性文档

* [游戏保存概述](/build/core-features/common/game-save/game-saves-overview)
* [XGameSaveFiles 指南](/build/core-features/common/game-save/xgamesavefiles)
* [游戏保存工具](/build/core-features/common/game-save/game-saves-tools)

## 另请参阅

[系统 API 参考](/reference/system/gc-reference-system-toc)


## Related topics

- [XGameSaveFiles API 概述](/zh-CN/build/core-features/common/game-save/xgamesavefiles.md)
- [XGameSaveFilesGetRemainingQuota](/zh-CN/reference/system/xgamesavefiles/functions/xgamesavefilesgetremainingquota.md)
- [XGameSaveFilesGetFolderWithUiAsync](/zh-CN/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md)
- [XGameSaveFilesGetFolderWithUiResult](/zh-CN/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiresult.md)
- [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)