Skip to main content

XblTitleStorageDownloadBlobAsync

タイトル ストレージから BLOB データをダウンロードします。

構文

パラメーター

xboxLiveContext   _In_
型: XblContextHandle
XblContextCreateHandle で作成された XBOX Live コンテキスト ハンドル。 blobMetadata   _In_
型: XblTitleStorageBlobMetadata
ダウンロードするタイトル ストレージ BLOB の BLOB メタデータ。 blobBuffer   _Out_writes_(blobBufferCount)
型: uint8_t*
ダウンロードした BLOB データを返す、呼び出し元が割り当てるバッファー。このバッファーは、ダウンロードする BLOB を格納できる十分な大きさである必要があります。必要に応じて、BLOB メタデータを取得することで必要なバッファーの長さを取得できます。 blobBufferCount   _In_
型: size_t
blobBuffer の長さ。 etagMatchCondition   _In_
型: XblTitleStorageETagMatchCondition
BLOB をダウンロードすべきかどうかを判断するために使用される ETag 一致条件。 selectQuery   _In_opt_z_
型: char*
フィルターに使用する ConfigStorage フィルター文字列、または JSONStorage の JSON プロパティ名文字列。(省略可能) preferredDownloadBlockSize   _In_
型: size_t
バイナリ BLOB の場合の、優先されるダウンロード ブロック サイズ (バイト単位)。既定のサイズを使用するには 0 を渡します。(省略可能) async   _In_
型: XAsyncBlock*
呼び出し元が割り当てる AsyncBlock。

戻り値

型: HRESULT この API 操作の HRESULT 戻り値コード。

解説

結果を取得するには、AsyncBlock コールバック内、または AsyncBlock の完了後に XblTitleStorageDownloadBlobResult を呼び出します。このメソッドは、blobBuffer に BLOB データを保持するのに十分な容量がない場合、E_NOT_SUFFICIENT_BUFFER (0x8007007A) を返します。

REST 呼び出し

V1 GET trustedplatform/users/xuid()/scids//data/,
V1 GET json/users/xuid()/scids//data/,
V1 GET global/scids//data/,
V1 GET sessions//scids//data/,

要件

ヘッダー: title_storage_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

title_storage_c
最終更新日 2026年8月24日