XGameSaveCreateContainer
XGameSaveContainer ハンドルを作成します。
構文
HRESULT XGameSaveCreateContainer(
XGameSaveProviderHandle provider,
const char* containerName,
XGameSaveContainerHandle* containerContext
)
パラメーター
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 へのハンドル。
戻り値
型: HRESULT
関数の結果です。 containerName が無効の場合、関数は E_GS_INVALID_CONTAINER_NAME (0x80830001) を返します。
解説
注意
この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。
注意
XGameSave API を使用するには、タイトルのタイトル ID とサービス構成 ID (SCID) が正しく構成されている必要があります。 これらの必須 ID の詳細については、「Xbox Live 開発のためのサンドボックスのセットアップ」をご覧ください。 パートナー センターでゲームを Xbox Live 向けに有効にする必要があります。
SCID とタイトル ID が正しく構成されていない場合は、XSaveGame API を呼び出したときに次のエラー コードが返されます。
E_GS_NO_ACCESS - 0x80830002 - 操作は、タイトルがコンテナー ストレージ領域へのアクセス権を持っていないために失敗しました。
XGameSaveCreateContainer は、新しいコンテナーの作成と、識別子として名前を使用することによる以前に作成されたコンテナーへのアクセスの両方に使用されます。 gamesave コンテナーには、XGameSaveBlobs の形式でプレイヤーに関する情報が保持されています。 BLOB はプレイヤーに関連付けられている特定のデータであり、そのデータには BLOB データを読み取るために役立つ他の情報と共に名前と値が含まれます。 XGameSaveContainerInfo 構造体で XGameSaveContainer の構成を検索できます。
注意
コンテナーに対して XGameSaveSubmitUpdate または XGameSaveSubmitUpdateAsync が呼び出されるまで、コンテナーは確定されません。 更新 API が呼び出されるまで、コンテナーは XGameSaveEnumerateContainerInfoByName の結果に提供されません。
要件
ヘッダー: XGameSave.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体