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

# 服務 C API 概觀 - PFGameSaveFiles.h

> 服務 C API 概觀 - PFGameSaveFiles.h

## 函式

| 函式 | 說明 |
| - | - |
| [PFGameSaveFilesActiveDeviceChangedCallback](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesactivedevicechangedcallback.md) | 作用中裝置變更時的回呼。觸發此回呼時，表示使用者已移至另一部裝置，因此此遊戲應返回主功能表 |
| [PFGameSaveFilesAddUserWithUiAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiasync.md) | 將使用者新增至遊戲存檔系統。這會視需要從雲端下載存檔狀態，且可能會觸發下列 UI 回呼：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。如需更多詳細資料，請參閱 PFGameSaveFilesSetUiCallbacks。必須先呼叫 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上，由系統提供內建 UI。 |
| [PFGameSaveFilesAddUserWithUiResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md) | 擷取呼叫 PFGameSaveFilesAddUserWithUiAsync 的結果。 |
| [PFGameSaveFilesGetFolder](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfolder.md) | 傳回此使用者遊戲存檔檔案和資料夾的根資料夾。其所有檔案和子資料夾都會與雲端同步。必須先使用 PFGameSaveFilesAddUserWithUiAsync 新增使用者。 |
| [PFGameSaveFilesGetFolderSize](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfoldersize.md) | 傳回此使用者遊戲存檔檔案和資料夾之根資料夾的大小 (以位元組為單位)。必須先使用 PFGameSaveFilesAddUserWithUiAsync 新增使用者。 |
| [PFGameSaveFilesGetRemainingQuota](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetremainingquota.md) | 傳回可使用 PFGameSaveFiles API 儲存存檔資料的可用資料量 (以位元組為單位)。超過配額時會傳回負數，並導致服務封鎖上傳。 |
| [PFGameSaveFilesInitialize](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize.md) | 初始化 PlayFab Game Save 程式庫執行個體。 |
| [PFGameSaveFilesIsConnectedToCloud](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud.md) | 傳回使用者是否已連線至雲端。在沒有網路存取的情況下呼叫 PFGameSaveFilesAddUserWithUiAsync()，且使用者在 PFGameSaveFilesUiSyncFailedCallback 中選擇 PFGameSaveFilesUiSyncFailedUserAction::UseOffline 時，使用者可能會與雲端中斷連線。如果另一部裝置成為作用中裝置，使用者也可能隨時與雲端中斷連線。與雲端中斷連線時，如果您想嘗試連線至雲端，可以再次呼叫 PFGameSaveFilesAddUserWithUiAsync()。如果網路仍處於離線狀態，則會再次顯示失敗 UI。不需要重新初始化 gamesave，但您可以視需要這麼做。與雲端中斷連線時，即使有網路存取，PFGameSaveFilesUploadWithUiAsync() 也不會執行任何動作，而只會在非同步完成中傳回 E\_PF\_GAMESAVE\_DISCONNECTED\_FROM\_CLOUD。 |
| [PFGameSaveFilesResetCloudAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudasync.md) | 這會重設此使用者的雲端遊戲存檔狀態。通常不需要呼叫此函式，但在開發或測試期間可能很有用。這不會刪除或變更本機遊戲存檔。 |
| [PFGameSaveFilesResetCloudResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudresult.md) | 擷取呼叫 PFGameSaveFilesResetCloudAsync 的結果。 |
| [PFGameSaveFilesSetActiveDeviceChangedCallback](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetactivedevicechangedcallback.md) | 設定作用中裝置變更回呼。觸發此回呼時，表示使用者已移至另一部裝置，因此此遊戲應返回主功能表 |
| [PFGameSaveFilesSetSaveDescriptionAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionasync.md) | 設定擱置中遊戲存檔的簡短存檔描述。這會顯示在衝突或作用中裝置爭用 UI 中 |
| [PFGameSaveFilesSetSaveDescriptionResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionresult.md) | 擷取呼叫 PFGameSaveFilesSetSaveDescriptionAsync 的結果。 |
| [PFGameSaveFilesUninitializeAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeasync.md) | 清除 PlayFab Game Save 程式庫執行個體。 |
| [PFGameSaveFilesUninitializeResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeresult.md) | 擷取呼叫 PFGameSaveFilesUninitializeAsync 的結果。 |
| [PFGameSaveFilesUploadWithUiAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiasync.md) | 上傳 PFGameSaveFilesGetFolder() 所傳回之資料夾中的所有檔案和資料夾。必須先新增使用者。在非 Windows 平台上，上傳會在與遊戲相同的處理序中進行，且可能會觸發下列 UI 回呼：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback。在 XBOX 和 Windows 平台上，上傳會在處理序外完成，並由系統提供內建 UI。在 XBOX 和 Windows 平台上，呼叫此 API 是選擇性的，因為上傳會在遊戲未執行時自動進行。 |
| [PFGameSaveFilesUploadWithUiResult](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiresult.md) | 擷取呼叫 PFGameSaveFilesUploadWithUiAsync 的結果。 |


## Related topics

- [服務 C API 概觀 - PFGameSaveFilesTypes.h](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefilestypes/pfgamesavefilestypes_members.md)
- [服務 C API 概觀 - PFGameSaveFilesUi.h](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [Game Saves 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/game-saves-overview.md)
- [XGameSaveFiles API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/xgamesavefiles.md)
- [PFGameSaveFilesInitialize](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize.md)