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

# Microsoft.Xbox.Wrappers.XGameSave.Provider 参考

> Reference for the Microsoft.Xbox.Wrappers.XGameSave.Provider class, the primary management type for initializing, loading, saving, and querying save containers.

# Microsoft.Xbox.Wrappers.XGameSave.Provider

**XGameSave** 包装器的主要管理类。

## 语法

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

## 方法

| 方法 | 说明 |
| - | - |
| [Initialize](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md) | 初始化游戏存档包装器，并同步指定用户的所有容器。 |
| [QueryContainers](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers.md) | 返回与所提供的名称前缀匹配的容器名称向量。 |
| [QueryContainerBlobs](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainerblobs.md) | 返回一个 [BlobInfo](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/structs/blobinfo.md) 对象向量，用于标识指定容器中的 blob（文件）。 |
| [Load](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md) | 从指定容器中给定的 blob（文件）加载数据。 |
| [Save](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) | 将数据保存到指定容器中指定的 blob（文件）。 |
| [GetQuota](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota.md) | 返回可使用游戏存档包装器存储的数据量。 |
| [Delete(std::string&)](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md) | 删除容器及其所有 blob（文件）。 |
| [Delete(std::string&, std::string&)](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_string.md) | 从指定容器中删除指定的 blob（文件）。 |
| [Delete(std::string&, BlobNames&)](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_blobnames.md) | 从指定容器中删除一个或多个 blob（文件）。 |

## 备注

**XGameSave** 简化包装器是一组 API，用于代表用户读取和写入数据，使其能够跨游戏会话持久化，并跨多个设备与云无缝同步。这些包装器 API 分为三类：

**Provider**

`gs_provider_t` 是将用户上下文绑定到游戏存档的句柄。它是 API 交互所必需的。每个提供程序可以包含多个容器，并且每个提供程序的默认配额为 256 MB。提供程序操作包括：

* 配额信息
* 容器管理
* 提供程序元数据（服务配置 ID、UserContext）

**Container**

你可以使用容器将数据在逻辑上关联为一个组，从而能够对其进行原子性的写入、更新和读取。容器操作包括：

* 查询容器信息和容器状态
* 查询容器内容
* 对容器数据的原子更新

**二进制大对象 (blob)**

Blob 包含容器中所包含的数据。一个 blob 所能包含的最大数据量为 16 MB。

* Blob 的更新和删除操作被设计为原子操作，因此一组更改可以在一次操作中提交。如果任何部分失败，则整个更新都会失败。

## 要求

**头文件：** xgamesavewrappers.hpp

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[Microsoft.Xbox.Wrappers.XGameSave.Provider](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider)\
[XGameSave 包装器成员](https://devdocs.xbox.com/zh-CN/reference/system/Wrappers/xgamesave_wrapper_members.md)\
[观察者设计模式](https://learn.microsoft.com/dotnet/standard/events/observer-design-pattern)


## Related topics

- [Save](https://devdocs.xbox.com/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [Initialize](https://devdocs.xbox.com/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)