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

# XGameSaveCreateContainer

> XGameSaveCreateContainer

# XGameSaveCreateContainer

XGameSaveContainer ハンドルを作成します。

## Syntax

```cpp theme={null}
HRESULT XGameSaveCreateContainer(  
         XGameSaveProviderHandle provider,  
         const char* containerName,  
         XGameSaveContainerHandle* containerContext  
)  
```

### Parameters

*provider*   \_In\_\
型: XGameSaveProviderHandle

コンテナーを作成する XGameSaveProvider へのハンドル。

*containerName*   \_In\_z\_\
型: char\*

作成するコンテナーの名前。

コンテナー名のパス部分 (最後のスラッシュを含む) で有効な文字は、大文字 (A-Z)、小文字 (a-z)、数字 (0-9)、アンダースコア (\_)、およびスラッシュ (/) です。パス部分は空でもかまいません。

ファイル名部分 (最後のスラッシュ以降のすべて) で有効な文字は、大文字 (A-Z)、小文字 (a-z)、数字 (0-9)、アンダースコア (\_)、ピリオド (.)、およびハイフン (-) です。ファイル名は空にすることはできず、ピリオドで終わったり、連続する 2 つのピリオドを含んだりすることはできません。

コンテナー名の最大長は 256 文字です。

*containerContext*   \_Outptr\_result\_nullonfailure\_\
型: XGameSaveContainerHandle\*

この関数呼び出しから返される XGameSaveContainer のハンドル。

### Return value

型: HRESULT

関数の結果。containerName が無効な場合、この関数は E\_GS\_INVALID\_CONTAINER\_NAME (0x80830001) を返します。

## Remarks

<Note>この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、[Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) を参照してください。</Note>

<Note>XGameSave API を動作させるには、タイトルのタイトル ID とサービス構成 ID (SCID) が</Note>
適切に構成されている必要があります。これらの必要な ID の詳細については、[Setting Up Sandboxes for XBOX Live Development](/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes) を参照してください。ゲームは Partner Center で XBOX Live に対して有効化されている必要があります。

SCID とタイトル ID が適切に構成されていない場合、XSaveGame API の呼び出しは次のエラー コードで失敗します。

E\_GS\_NO\_ACCESS - 0x80830002 - タイトルがコンテナー ストレージ領域にアクセスできないため、操作は失敗しました。

XGameSaveCreateContainer は、新しいコンテナーの作成と、名前を識別子として使って以前に作成されたコンテナーへのアクセスの両方に使用されます。ゲーム セーブ コンテナーは、[XGameSaveBlobs](/reference/system/xgamesave/structs/xgamesaveblob) の形式でプレイヤーに関する情報を保持します。BLOB は、プレイヤーに関連付けられた特定のデータであり、そのデータには名前と値、および BLOB データの読み取りを助けるその他の情報が含まれます。**XGameSaveContainer** の構成については、[XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo) 構造体を参照してください。

<Note>コンテナーは、[XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate) または [XGameSaveSubmitUpdateAsync](/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) がコンテナーに対して呼び出されるまで確定されません。update API が呼び出されるまでは、コンテナーは [XGameSaveEnumerateContainerInfoByName](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) の結果には出力されません。</Note>

## Requirements

**ヘッダー:** XGameSave.h

**ライブラリ:** xgameruntime.lib

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

## Conceptual documentation

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[XGameSaveBlob](/reference/system/xgamesave/structs/xgamesaveblob)\
[Debugging Game Saves](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveCloseContainer](/ja-jp/reference/system/xgamesave/functions/xgamesaveclosecontainer.md)
- [XGameSaveGetContainerInfo](/ja-jp/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [XGameSave API の概要](/ja-jp/build/core-features/common/game-save/xgamesave.md)
- [XGameSave](/ja-jp/reference/system/xgamesave/xgamesave_members.md)
- [GDK 向け Unity C# API ラッパー](/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)