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日