XGameSaveEnumerateBlobInfoByName

XGameSaveContainer から blobNamePrefix パラメーターで指定したプレフィックスと一致する BLOB の情報だけを取得します。

構文

HRESULT XGameSaveEnumerateBlobInfoByName(  
         XGameSaveContainerHandle container,  
         const char* blobNamePrefix,  
         void* context,  
         XGameSaveBlobInfoCallback* callback  
)  

パラメーター

container _In_
型: XGameSaveContainerHandle

列挙する BLOB が格納されている XGameSaveContainer に対するハンドル。

blobNamePrefix _In_opt_z_
型: char*

取得する BLOB のフィルター処理に使用するプレフィックス。

context _In_opt_
型: void*

コンテキストのための呼び出し元オブジェクトへのポインター。

callback _In_
型: XGameSaveBlobInfoCallback*

プレフィックスが一致するすべての BLOB に対して呼び出される関数。列挙を停止するには false を返します。 これを使用して XGameSaveBlobInfo を反復処理し、関数呼び出しが成功したことを確認します。

戻り値

型: HRESULT

関数の結果です。

解説

注意

この関数は時間依存のスレッドで呼び出すのに安全ですが、XGameSaveBlobInfoCallback は、タイトルがコールバック内で実行する内容に応じて遅延を引き起こす可能性があります。 たとえば、コールバックからデータをコピーすることは問題ありません。ただし、時間に依存しない呼び出しを行うと、コールバックの戻りが遅れる可能性があります。 詳細については、「時間依存のスレッド」を参照してください。

BLOB には、コンテナーを構成する実際の取得可能なデータが含まれます。 BLOB を列挙すると、コンテナー内で利用可能なすべてのデータを表示できます。 プレフィックスでフィルター処理せずに、コンテナーのすべての BLOB を列挙するには、XGameSaveEnumerateBlobInfo を使用できます。

要件

ヘッダー: XGameSave.h

ライブラリ: xgameruntime.lib

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

関連項目

XGameSave
XGameSaveBlobInfo
XGameSaveEnumerateBlobInfo
ゲームのセーブ エラー