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

# XGameSave

> XGameSave

# XGameSave

XGameSave API 的設計目的是讓您能夠建立、載入、儲存和管理遊戲相關狀態。此實作與先前實作的主要差異在於，它將提供一個扁平 API，可存取非同步程式設計模型，讓呼叫端能夠控制 API 行為的執行緒處理和記憶體管理。

## 函式

| 函式 | 描述 |
| - | - |
| [XGameSaveBlobInfoCallback](/zh-TW/reference/system/xgamesave/functions/xgamesaveblobinfocallback) | 用來擷取 [XGameSaveEnumerateBlobInfo](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) 結果的回呼函式。 |
| [XGameSaveCloseContainer](/zh-TW/reference/system/xgamesave/functions/xgamesaveclosecontainer) | 關閉 XGameSaveContainer。 |
| [XGameSaveCloseProvider](/zh-TW/reference/system/xgamesave/functions/xgamesavecloseprovider) | 釋放 XGameSaveProvider 所保留的資源。 |
| [XGameSaveCloseUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavecloseupdate) | 關閉 XGameSaveUpdate。 |
| [XGameSaveContainerInfoCallback](/zh-TW/reference/system/xgamesave/functions/xgamesavecontainerinfocallback) | 對 [XGameSaveGetContainerInfo](/zh-TW/reference/system/xgamesave/functions/xgamesavegetcontainerinfo) 所進行之呼叫的回呼函式。 |
| [XGameSaveCreateContainer](/zh-TW/reference/system/xgamesave/functions/xgamesavecreatecontainer) | 建立 XGameSaveContainer 控制代碼。 |
| [XGameSaveCreateUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavecreateupdate) | 建立稍後將透過呼叫 [XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate) 提交的更新。 |
| [XGameSaveDeleteContainer](/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainer) | 從雲端儲存體刪除 XGameSaveContainer。 |
| [XGameSaveDeleteContainerAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) | 以非同步方式刪除 XGameSaveContainer。 |
| [XGameSaveDeleteContainerResult](/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainerresult) | 擷取 [XGameSaveDeleteContainerAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) 呼叫的結果，請使用此函式檢查呼叫是否成功。 |
| [XGameSaveEnumerateBlobInfo](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) | 擷取 XGameSaveContainer 內容的 Blob 資訊。 |
| [XGameSaveEnumerateBlobInfoByName](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname) | 擷取 XGameSaveContainer 內容的 Blob 資訊，僅限於與 blobNamePrefix 參數共用前置詞的 Blob。 |
| [XGameSaveEnumerateContainerInfo](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) | 擷取 XGameSaveProvider 的容器資訊。 |
| [XGameSaveEnumerateContainerInfoByName](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) | 擷取 XGameSaveProvider 的容器資訊。 |
| [XGameSaveGetContainerInfo](/zh-TW/reference/system/xgamesave/functions/xgamesavegetcontainerinfo) | 擷取 XGameSaveProvider 中容器的資訊。 |
| [XGameSaveGetRemainingQuota](/zh-TW/reference/system/xgamesave/functions/xgamesavegetremainingquota) | 傳回可使用 XGameSave API 儲存的資料量。 |
| [XGameSaveGetRemainingQuotaAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync) | 以非同步方式傳回可使用 XGameSave API 儲存的資料量。 |
| [XGameSaveGetRemainingQuotaResult](/zh-TW/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult) | 擷取 [XGameSaveGetRemainingQuotaAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync) 函式的結果。 |
| [XGameSaveInitializeProvider](/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeprovider) | 提供並初始化 XGameSave Provider 控制代碼。 |
| [XGameSaveInitializeProviderAsync](/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) | 以非同步方式提供並初始化 XGameSave Provider 控制代碼。 |
| [XGameSaveInitializeProviderResult](/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult) | 包含 [XGameSaveInitializeProviderAsync](/zh-TW/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) 呼叫的結果。 |
| [XGameSaveReadBlobData](/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdata) | 讀取容器的 Blob 資料。 |
| [XGameSaveReadBlobDataAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync) | 以非同步方式從 XGameSaveContainer 讀取 XGameSaveBlob 資料。 |
| [XGameSaveReadBlobDataResult](/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataresult) | 擷取 [XGameSaveReadBlobDataAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync) 呼叫的結果。 |
| [XGameSaveSubmitBlobDelete](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobdelete) | 將刪除動作新增至遊戲存檔 XGameSaveUpdate。 |
| [XGameSaveSubmitBlobWrite](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) | 將寫入動作新增至 XGameSaveUpdate。 |
| [XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate) | 將更新提交至 XGameSave 服務。更新容器內的 Blob。 |
| [XGameSaveSubmitUpdateAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) | 以非同步方式將更新提交至 XGameSave 服務。更新容器內的 Blob。 |
| [XGameSaveSubmitUpdateResult](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdateresult) | 擷取 [XGameSaveSubmitUpdateAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) 呼叫的結果。 |

## 結構

| 結構 | 描述 |
| - | - |
| [XGameSaveBlob](/zh-TW/reference/system/xgamesave/structs/xgamesaveblob) | XGameSave 儲存體的資訊單位。位於 XGameSaveContainer 內。 |
| [XGameSaveBlobInfo](/zh-TW/reference/system/xgamesave/structs/xgamesaveblobinfo) | XGameSaveBlob 的相關資訊。 |
| [XGameSaveContainerInfo](/zh-TW/reference/system/xgamesave/structs/xgamesavecontainerinfo) | XGameSaveContainer 的相關資訊。 |

## 錯誤碼

XGameSave API 可能會傳回下列錯誤碼。如需完整清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。如需詳細的疑難排解指引，請參閱[偵錯遊戲存檔](/zh-TW/build/core-features/common/game-save/game-saves-debugging)。

| 代碼 | 值 | 描述 |
| - | - | - |
| E\_GS\_INVALID\_CONTAINER\_NAME | 0x80830001 | 容器名稱無效。有效的容器名稱字元包括大寫/小寫字母、數字、底線和正斜線。 |
| E\_GS\_NO\_ACCESS | 0x80830002 | 作業失敗，因為遊戲無法存取容器儲存空間。請檢查 SCID 和 TitleId 是否已正確設定。 |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE | 0x80830003 | 裝置沒有足夠的儲存容量來儲存遊戲。 |
| E\_GS\_USER\_CANCELED | 0x80830004 | 使用者取消了其遊戲存檔的下載。 |
| E\_GS\_UPDATE\_TOO\_BIG | 0x80830005 | 存檔更新的大小過大。XGameSave 更新的總大小必須小於 GS\_MAX\_BLOB\_SIZE (16 MB)。 |
| E\_GS\_QUOTA\_EXCEEDED | 0x80830006 | 已超過此使用者的遊戲儲存配額。 |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL | 0x80830007 | 提供給 API 的緩衝區太小。 |
| E\_GS\_BLOB\_NOT\_FOUND | 0x80830008 | 找不到指定的 Blob。 |
| E\_GS\_NO\_SERVICE\_CONFIGURATION | 0x80830009 | 遊戲未針對 Connected Storage 正確設定。請檢查 SCID 是否正確，以及遊戲是否已在 Partner Center 中設定。 |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC | 0x8083000A | 容器尚未同步。提交更新之前，請確定 XGameSave 容器已同步。 |
| E\_GS\_CONTAINER\_SYNC\_FAILED | 0x8083000B | 容器同步失敗。 |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | 使用者的 MSA 尚未成為 XBOX services 帳戶。 |
| E\_GS\_HANDLE\_EXPIRED | 0x8083000D | 函式所使用的控制代碼已過期，必須重新取得。 |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED | 0x8083000E | 此同步函式正在時間敏感執行緒上呼叫，有發生死結的風險。請改用非同步實作。 |
| E\_GS\_PROVIDER\_MISMATCH | 0x8083000F | 遊戲混用了 XGameSave 和 XGameSaveFiles 呼叫，這是不支援的。 |

## 概念文件

* [遊戲存檔概觀](/zh-TW/build/core-features/common/game-save/game-saves-overview)
* [XGameSave 指南](/zh-TW/build/core-features/common/game-save/xgamesave)
* [偵錯遊戲存檔](/zh-TW/build/core-features/common/game-save/game-saves-debugging)

## 另請參閱

[系統 API 參考](/zh-TW/reference/system/gc-reference-system-toc)


## Related topics

- [XGameSave](/reference/system/xgamesave/xgamesave_members.md)
- [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSave API overview](/build/core-features/common/game-save/xgamesave.md)
- [XGameSave Provider Save method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)