> ## 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 class reference

> 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

The primary management class for the **XGameSave** wrapper.

<a id="syntaxSection" />

## Syntax

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

## Methods

| Method                                                                                                                                     | Description                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| [Initialize](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize)                                    | Intializes the save game wrapper, and synchronizes all of the containers for the specified user.                                                |
| [QueryContainers](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers)                          | Returns a vector of container names that match the supplied name prefix.                                                                        |
| [QueryContainerBlobs](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainerblobs)                  | Returns a vector of [BlobInfo](/reference/system/Wrappers/structs/blobinfo) objects that identify the blobs (files) in the specified container. |
| [Load](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load)                                                | Loads the data from the given blob (file), from within the specified container.                                                                 |
| [Save](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save)                                                | Saves data to the specified blob (file) within the specified container.                                                                         |
| [GetQuota](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota)                                        | Returns the amount of data available to store using the save game wrapper.                                                                      |
| [Delete(std::string&)](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string)                       | Deletes a container along with all of its blobs (files).                                                                                        |
| [Delete(std::string&, std::string&)](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_string)  | Deletes the specified blobs (files) from the specified container.                                                                               |
| [Delete(std::string&, BlobNames&)](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_blobnames) | Deletes one or more blobs (files) from the specified container.                                                                                 |

<a id="remarksSection" />

## Remarks

The **XGameSave** simplified wrapper is a set of API's that enable reading and writing data on behalf of a user, to be persisted across game sessions, and to seamlessly sync with the cloud across multiple devices. The wrapper APIs fall into three categories:

**Providers**

`gs_provider_t` is the handle that binds a user context to a game save. It's required for API interactions. Each provider can contain multiple containers, and each provider has a default quota of 256 MB. Provider operations include:

* Quota information
* Container management
* Provider Metadata (Service Configuration ID, UserContext)

**Containers**

You can use containers to logically correlate data into a group that can be written to, updated, and read from atomically. Container operations include:

* Queries on container info, and container status
* Queries on container contents
* Atomic updates to container data

**Binary large objects (blobs)**

Blobs contain the data contained within a container. The maximum amount of data that a blob can contain is 16 MB.

* Blob update and delete operations are designed to be atomic, so that a set of changes can be committed in one operation. If any portion fails, then the entire update fails.

<a id="requirementsSection" />

## Requirements

**Header:** xgamesavewrappers.hpp

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

<a id="seealsoSection" />

## See also

[Microsoft.Xbox.Wrappers.XGameSave.Provider](/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider)\
[XGameSave wrapper members](/reference/system/Wrappers/xgamesave_wrapper_members)\
[Observer Design Pattern](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 Wrapper reference index and member list](/reference/system/Wrappers/xgamesave_wrapper_members.md)