Skip to main content

XGameSaveCreateContainer

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

Syntax

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

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
XGameSave API を動作させるには、タイトルのタイトル ID とサービス構成 ID (SCID) が
適切に構成されている必要があります。これらの必要な ID の詳細については、Setting Up Sandboxes for XBOX Live Development を参照してください。ゲームは Partner Center で XBOX Live に対して有効化されている必要があります。
SCID とタイトル ID が適切に構成されていない場合、XSaveGame API の呼び出しは次のエラー コードで失敗します。 E_GS_NO_ACCESS - 0x80830002 - タイトルがコンテナー ストレージ領域にアクセスできないため、操作は失敗しました。 XGameSaveCreateContainer は、新しいコンテナーの作成と、名前を識別子として使って以前に作成されたコンテナーへのアクセスの両方に使用されます。ゲーム セーブ コンテナーは、XGameSaveBlobs の形式でプレイヤーに関する情報を保持します。BLOB は、プレイヤーに関連付けられた特定のデータであり、そのデータには名前と値、および BLOB データの読み取りを助けるその他の情報が含まれます。XGameSaveContainer の構成については、XGameSaveContainerInfo 構造体を参照してください。
コンテナーは、XGameSaveSubmitUpdate または XGameSaveSubmitUpdateAsync がコンテナーに対して呼び出されるまで確定されません。update API が呼び出されるまでは、コンテナーは XGameSaveEnumerateContainerInfoByName の結果には出力されません。

Requirements

ヘッダー: XGameSave.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XGameSave
XGameSaveContainerInfo
XGameSaveBlob
Debugging Game Saves
最終更新日 2026年8月24日