次の方法で共有

XGameSaveEnumerateContainerInfo

  • [アーティクル]

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

構文

HRESULT XGameSaveEnumerateContainerInfo(  
         XGameSaveProviderHandle provider,  
         void* context,  
         XGameSaveContainerInfoCallback* callback  
)

パラメーター

provider _In_
型: XGameSaveProviderHandle

XGameSaveContainerInfo が格納されている XGameSaveProvider に対するハンドル。

context _In_opt_
型: void*

コールバック関数に渡されるポインター。

callback _In_
型: XGameSaveContainerInfoCallback*

すべてのコンテナーに対して実行するコールバック関数。列挙を停止するには false を返します。 この関数を使用して、XGameSaveContainerInfo を収集します。

戻り値

型: HRESULT

関数の結果です

解説

この関数を使用して、ユーザーの利用可能なコンテナーを検査します。 これには、UX で表示する必要があるデータが含まれる場合があります。 このセットを列挙しても、SyncOnDemand プロバイダーとの同期は行われず、呼び出し元は XGameSaveContainerInfo の needsSync フィールドで同期のステータスを実際に調べることができます。 needsSync が true に設定されたコンテナーで BLOB データを読み取ったり、更新コンテキストを使用したりすると、同期が強制的に行われ、さまざまな同期エラーが返る可能性があります。 XGameSaveEnumerateContainerInfoByName を使用すると、一致する必要があるプレフィックスを指定して、コンテナーの情報が返される前にコンテナーをフィルター処理できます。

要件

ヘッダー: XGameSave.h

ライブラリ: xgameruntime.lib

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

関連項目

XGameSave
XGameSaveEnumerateContainerInfoByName
XGameSaveContainerInfo
ゲームのセーブ エラー