> ## 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 リファレンス

> セーブ コンテナーの初期化、読み込み、保存、クエリを行うためのプライマリ管理型である Microsoft.Xbox.Wrappers.XGameSave.Provider クラスのリファレンス。

# Microsoft.Xbox.Wrappers.XGameSave.Provider

**XGameSave** ラッパー用のプライマリ管理クラス。

## 構文

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

## メソッド

| メソッド | 説明 |
| - | - |
| [Initialize](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md) | セーブ ゲーム ラッパーを初期化し、指定されたユーザーのすべてのコンテナーを同期します。 |
| [QueryContainers](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers.md) | 指定された名前プレフィックスに一致するコンテナー名のベクターを返します。 |
| [QueryContainerBlobs](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainerblobs.md) | 指定されたコンテナー内の Blob (ファイル) を識別する [BlobInfo](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/structs/blobinfo.md) オブジェクトのベクターを返します。 |
| [Load](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md) | 指定されたコンテナー内の、指定された Blob (ファイル) からデータを読み込みます。 |
| [Save](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) | 指定されたコンテナー内の、指定された Blob (ファイル) にデータを保存します。 |
| [GetQuota](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota.md) | セーブ ゲーム ラッパーを使用して保存できるデータ量を返します。 |
| [Delete(std::string&)](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md) | コンテナーをその Blob (ファイル) と共にすべて削除します。 |
| [Delete(std::string&, std::string&)](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_string.md) | 指定されたコンテナーから、指定された Blob (ファイル) を削除します。 |
| [Delete(std::string&, BlobNames&)](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_blobnames.md) | 指定されたコンテナーから 1 つまたは複数の Blob (ファイル) を削除します。 |

## 解説

**XGameSave** 簡易ラッパーは、ユーザーの代理としてデータを読み書きし、ゲーム セッションを越えて永続化し、複数のデバイス間でクラウドとシームレスに同期できるようにする API のセットです。ラッパー API は 3 つのカテゴリに分類されます。

**プロバイダー**

`gs_provider_t` は、ユーザー コンテキストをゲーム セーブにバインドするハンドルです。API のやり取りに必要です。各プロバイダーは複数のコンテナーを含めることができ、各プロバイダーには 256 MB の既定クォータがあります。プロバイダー操作には次のものが含まれます。

* クォータ情報
* コンテナー管理
* プロバイダー メタデータ (サービス構成 ID、UserContext)

**コンテナー**

コンテナーを使用して、データを論理的にグループに関連付け、アトミックに書き込み、更新、および読み取ることができます。コンテナー操作には次のものが含まれます。

* コンテナー情報とコンテナー ステータスに関するクエリ
* コンテナー コンテンツに関するクエリ
* コンテナー データへのアトミックな更新

**Binary large object (Blob)**

Blob には、コンテナー内に含まれるデータが格納されます。Blob に格納できるデータの最大量は 16 MB です。

* Blob の更新および削除操作はアトミックになるように設計されており、一連の変更を 1 回の操作でコミットできます。一部が失敗した場合、更新全体が失敗します。

## 要件

**ヘッダー:** xgamesavewrappers.hpp

**サポートされているプラットフォーム:** Windows、XBOX One ファミリ本体および XBOX Series 本体

## 関連項目

[Microsoft.Xbox.Wrappers.XGameSave.Provider](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider)\
[XGameSave ラッパーのメンバー](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/xgamesave_wrapper_members.md)\
[オブザーバー デザイン パターン](https://learn.microsoft.com/dotnet/standard/events/observer-design-pattern)


## Related topics

- [XGameSave Wrapper リファレンス (API の内容)](https://devdocs.xbox.com/ja-jp/reference/system/Wrappers/xgamesave_wrapper_members.md)
- [Microsoft Game Development Kit (GDK) のシステム API リファレンス資料](https://devdocs.xbox.com/ja-jp/reference/system/gc-reference-system-toc.md)
- [MicrosoftGame.config 要素リファレンス (目次)](https://devdocs.xbox.com/ja-jp/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md)
- [MicrosoftGame.config 追加リファレンス](https://devdocs.xbox.com/ja-jp/reference/system/microsoftgameconfig/microsoftgameconfig-schema.md)
- [MicrosoftGame.config エディターとリファレンス](https://devdocs.xbox.com/ja-jp/build/core-features/common/game-config/index.md)