> ## 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 Wrapper Provider 類別參考

> Microsoft.Xbox.Wrappers.XGameSave.Provider 類別的參考資料，這是用於初始化、載入、儲存及查詢存檔容器的主要管理類型。

# Microsoft.Xbox.Wrappers.XGameSave.Provider

**XGameSave** 包裝函式的主要管理類別。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
class Provider
```

## 方法

| 方法 | 描述 |
| - | - |
| [Initialize](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize) | 初始化遊戲存檔包裝函式，並同步處理指定使用者的所有容器。 |
| [QueryContainers](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers) | 傳回符合所提供名稱前置詞的容器名稱向量。 |
| [QueryContainerBlobs](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainerblobs) | 傳回 [BlobInfo](/zh-TW/reference/system/Wrappers/structs/blobinfo) 物件的向量，用以識別指定容器中的 Blob (檔案)。 |
| [Load](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load) | 從指定的容器中載入指定 Blob (檔案) 的資料。 |
| [Save](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save) | 將資料儲存到指定容器內的指定 Blob (檔案)。 |
| [GetQuota](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota) | 傳回可使用遊戲存檔包裝函式儲存的資料量。 |
| [Delete(std::string&)](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string) | 刪除容器及其所有 Blob (檔案)。 |
| [Delete(std::string&, std::string&)](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_string) | 從指定的容器中刪除指定的 Blob (檔案)。 |
| [Delete(std::string&, BlobNames&)](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_blobnames) | 從指定的容器中刪除一或多個 Blob (檔案)。 |

<a id="remarksSection" />

## 備註

**XGameSave** 簡化包裝函式是一組 API，可代表使用者讀取和寫入資料，讓資料在遊戲工作階段之間保存，並跨多部裝置與雲端順暢同步。包裝函式 API 分為三類：

**提供者**

`gs_provider_t` 是將使用者內容繫結至遊戲存檔的控制代碼。API 互動需要用到它。每個提供者可以包含多個容器，而每個提供者的預設配額為 256 MB。提供者作業包括：

* 配額資訊
* 容器管理
* 提供者中繼資料 (服務設定識別碼、UserContext)

**容器**

您可以使用容器，以邏輯方式將資料關聯成一個群組，並以不可部分完成的方式寫入、更新和讀取。容器作業包括：

* 查詢容器資訊和容器狀態
* 查詢容器內容
* 以不可部分完成的方式更新容器資料

**二進位大型物件 (Blob)**

Blob 包含容器內所含的資料。一個 Blob 可包含的資料量上限為 16 MB。

* Blob 更新和刪除作業設計為不可部分完成，因此一組變更可在單一作業中認可。如果任何部分失敗，則整個更新都會失敗。

<a id="requirementsSection" />

## 需求

**標頭：** xgamesavewrappers.hpp

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

<a id="seealsoSection" />

## 另請參閱

[Microsoft.Xbox.Wrappers.XGameSave.Provider](/zh-TW/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider)\
[XGameSave 包裝函式成員](/zh-TW/reference/system/Wrappers/xgamesave_wrapper_members)\
[觀察者設計模式](https://learn.microsoft.com/dotnet/standard/events/observer-design-pattern)


## Related topics

- [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSave Provider Save method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSave Provider Initialize method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [XGameSave Provider Load method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md)
- [XGameSave Provider Delete(std::string&) method](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md)