Skip to main content

XblTitleStorageDownloadBlobAsync

從 Title Storage 下載 Blob 資料。

語法

參數

xboxLiveContext   _In_
類型:XblContextHandle
使用 XblContextCreateHandle 建立的 Xbox Live 內容控制代碼。 blobMetadata   _In_
類型:XblTitleStorageBlobMetadata
要下載之 Title Storage 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
Last modified on October 6, 2026