Skip to main content

XGameSaveGetContainerInfo

XGameSaveProvider 内のコンテナーの情報を取得します。

Syntax

Parameters

provider   _In_
型: XGameSaveProviderHandle
目的のコンテナーを含む XGameSaveProvider ハンドル。 containerName   _In_z_
型: char*
情報を取得するコンテナーの名前。見つかった場合は 1 つの結果のみを返します。複数のコンテナーが必要な場合は XGameSaveEnumerateContainerInfo または XGameSaveEnumerateContainerInfoByName を使用してください。 context   _In_opt_
型: void*
コンテキストの呼び出し元オブジェクトへのポインター。 callback   _In_
型: XGameSaveContainerInfoCallback*
XGameSaveContainerInfo 呼び出しの結果を判別し、そこからデータを収集するコールバック関数。

Return value

型: HRESULT 関数の結果

Common errors

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_USER_CANCELED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Remarks

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
コンテナーは、メタデータのコレクションと、その中の BLOB のセットの参照ポイントです。コンテナー名が事前にわかっている場合は、この API を使用してそのコンテナーだけの情報を返すことが可能です。これは、情報が必要になるたびにすべての情報を要求するのではなく、プレイヤーに関する特定の情報を取り戻すのに役立ちます。XGameSaveContainer の構成については、XGameSaveContainerInfo 構造体を参照してください。

Requirements

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

Conceptual documentation

See also

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