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

# 服务 C API 概览 - PFGameSaveFiles.h

> 服务 C API 概览 - PFGameSaveFiles.h

## 函数

| 函数 | 说明 |
| - | - |
| [PFGameSaveFilesActiveDeviceChangedCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesactivedevicechangedcallback) | 活动设备更改时的回调。触发此回调时，表示用户已移至另一台设备，因此此游戏应返回主菜单 |
| [PFGameSaveFilesAddUserWithUiAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiasync) | 将用户添加到游戏存档系统。这会根据需要从云下载存档状态，并可能触发以下 UI 回调：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。有关更多详细信息，请参阅 PFGameSaveFilesSetUiCallbacks。必须事先调用 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上，由系统提供标准 UI。 |
| [PFGameSaveFilesAddUserWithUiResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult) | 获取对 PFGameSaveFilesAddUserWithUiAsync 的调用结果。 |
| [PFGameSaveFilesGetFolder](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfolder) | 返回此用户的游戏存档文件和文件夹的根文件夹。其所有文件和子文件夹都将与云同步。必须先使用 PFGameSaveFilesAddUserWithUiAsync 添加用户。 |
| [PFGameSaveFilesGetFolderSize](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfoldersize) | 返回此用户的游戏存档文件和文件夹的根文件夹大小（以字节为单位）。必须先使用 PFGameSaveFilesAddUserWithUiAsync 添加用户。 |
| [PFGameSaveFilesGetRemainingQuota](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetremainingquota) | 返回可使用 PFGameSaveFiles API 存储存档数据的可用数据量（以字节为单位）。超出配额将返回负数，并导致服务阻止上传。 |
| [PFGameSaveFilesInitialize](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize) | 初始化 PlayFab Game Save 库实例。 |
| [PFGameSaveFilesIsConnectedToCloud](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud) | 返回用户是否已连接到云。在没有网络访问的情况下调用 PFGameSaveFilesAddUserWithUiAsync()，且用户在 PFGameSaveFilesUiSyncFailedCallback 中选择 PFGameSaveFilesUiSyncFailedUserAction::UseOffline 时，用户可能会与云断开连接。如果另一台设备成为活动设备，用户也可能随时与云断开连接。与云断开连接后，如果想要尝试连接到云，可以再次调用 PFGameSaveFilesAddUserWithUiAsync()。如果网络仍处于脱机状态，将再次显示失败 UI。无需重新初始化 gamesave，但如果需要也可以这样做。与云断开连接时，即使有网络访问，PFGameSaveFilesUploadWithUiAsync() 也不会执行任何操作，而是在异步完成中返回 E\_PF\_GAMESAVE\_DISCONNECTED\_FROM\_CLOUD。 |
| [PFGameSaveFilesResetCloudAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudasync) | 这会重置此用户的云游戏存档状态。通常无需调用此函数，但在开发或测试期间可能很有用。这不会删除或更改本地游戏存档。 |
| [PFGameSaveFilesResetCloudResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudresult) | 获取对 PFGameSaveFilesResetCloudAsync 的调用结果。 |
| [PFGameSaveFilesSetActiveDeviceChangedCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetactivedevicechangedcallback) | 设置活动设备更改回调。触发此回调时，表示用户已移至另一台设备，因此此游戏应返回主菜单 |
| [PFGameSaveFilesSetSaveDescriptionAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionasync) | 设置待处理游戏存档的简短存档说明。可在冲突或活动设备争用 UI 中看到此说明 |
| [PFGameSaveFilesSetSaveDescriptionResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionresult) | 获取对 PFGameSaveFilesSetSaveDescriptionAsync 的调用结果。 |
| [PFGameSaveFilesUninitializeAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeasync) | 清理 PlayFab Game Save 库实例。 |
| [PFGameSaveFilesUninitializeResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeresult) | 获取对 PFGameSaveFilesUninitializeAsync 的调用结果。 |
| [PFGameSaveFilesUploadWithUiAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiasync) | 上传 PFGameSaveFilesGetFolder() 返回的文件夹中的所有文件和文件夹。必须先添加用户。在非 Windows 平台上，上传在游戏所在的同一进程中进行，并可能触发以下 UI 回调：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback。在 XBOX 和 Windows 平台上，上传在进程外完成，并由系统提供标准 UI。在 XBOX 和 Windows 平台上，调用此 API 是可选的，因为上传会在游戏未运行时自动进行。 |
| [PFGameSaveFilesUploadWithUiResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiresult) | 获取对 PFGameSaveFilesUploadWithUiAsync 的调用结果。 |


## Related topics

- [服务 C API 概览 - PFGameSaveFilesTypes.h](/zh-CN/services/playfab/api-references/c/pfgamesavefilestypes/pfgamesavefilestypes_members.md)
- [服务 C API 概览 - PFGameSaveFilesUi.h](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [PFGameSaveFilesInitialize](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize.md)
- [PFGameSaveFilesSetSaveDescriptionAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionasync.md)
- [PFGameSaveFilesSetSaveDescriptionResult](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionresult.md)