Skip to main content

XGameSaveEnumerateContainerInfoByName

XGameSaveProvider のコンテナー情報を取得します。プレフィックスを指定すると、この関数は同じプレフィックスを持つワードのみを返します。

Syntax

Parameters

provider   _In_
型: XGameSaveProviderHandle
XGameSaveContainerInfo を含む XGameSaveProvider containerNamePrefix   _In_opt_z_
型: char*
一致するコンテナー名を検索するためにコンテナーのリストで使用されるプレフィックス。 context   _In_opt_
型: void*
コールバック関数に渡されるポインター。 callback   _In_
型: XGameSaveContainerInfoCallback*
プレフィックスに一致するすべてのコンテナーについて実行するコールバック関数。列挙を停止するには false を返します。この関数を使用して XGameSaveContainerInfo を収集します。

Return value

型: HRESULT 関数の結果。

Remarks

この関数を使用して、ユーザーに対してどのコンテナーが利用可能かを調べます。これには、UX で表示する必要があるデータが含まれる場合があります。このセットの列挙は、SyncOnDemand プロバイダーの同期を発生させず、呼び出し元が XGameSaveContainerInfo の needsSync フィールドを介して実際に同期ステータスを検査できるようにします。needsSync が true に設定されているコンテナーの BLOB データの読み取り、または更新コンテキストの使用は、強制的に同期を行い、さまざまな同期エラーが返される可能性があります。列挙するコンテナーのプレフィックスを指定する必要がない場合は、XGameSaveEnumerateContainerInfo を使用できます。XGameSaveEnumerateContainerInfo は、利用可能なコンテナーの完全なリストを返します。

Requirements

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

Conceptual documentation

See also

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