> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblTitleStorageDownloadBlobAsync

> XblTitleStorageDownloadBlobAsync

# XblTitleStorageDownloadBlobAsync

从标题存储下载 Blob 数据。

## 语法

```cpp theme={null}
HRESULT XblTitleStorageDownloadBlobAsync(  
         XblContextHandle xboxLiveContext,  
         XblTitleStorageBlobMetadata blobMetadata,  
         uint8_t* blobBuffer,  
         size_t blobBufferCount,  
         XblTitleStorageETagMatchCondition etagMatchCondition,  
         const char* selectQuery,  
         size_t preferredDownloadBlockSize,  
         XAsyncBlock* async  
)  
```

### 参数

*xboxLiveContext*   \_In\_\
类型：[XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

使用 XblContextCreateHandle 创建的 XBOX Live 上下文句柄。

*blobMetadata*   \_In\_\
类型：[XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata)

要下载的标题存储 Blob 的 Blob 元数据。

*blobBuffer*   \_Out\_writes\_(blobBufferCount)\
类型：uint8\_t\*

调用方分配的缓冲区，用于回传已下载的 Blob 数据。此缓冲区需要足够大以存储正在下载的 Blob。如有必要，可通过获取 Blob 元数据来检索缓冲区所需的长度。

*blobBufferCount*   \_In\_\
类型：size\_t

blobBuffer 的长度。

*etagMatchCondition*   \_In\_\
类型：[XblTitleStorageETagMatchCondition](/reference/live/xsapi-c/title_storage_c/enums/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](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult)。如果 blobBuffer 没有足够的容量来容纳 Blob 数据，此方法将返回 E\_NOT\_SUFFICIENT\_BUFFER (0x8007007A)。

## REST 调用

V1 GET trustedplatform/users/xuid({xuid})/scids/{scid}/data/{path},{type}\
V1 GET json/users/xuid({xuid})/scids/{scid}/data/{path},{type}\
V1 GET global/scids/{scid}/data/{path},{type}\
V1 GET sessions/{sessionId}/scids/{scid}/data/{path},{type}

## 要求

**头文件：** title\_storage\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[title\_storage\_c](/reference/live/xsapi-c/title_storage_c/title_storage_c_members)


## Related topics

- [XblTitleStorageDownloadBlobResult](/zh-CN/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult.md)
- [从 Title Storage 下载 blob](/zh-CN/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [XblTitleStorageUploadBlobAsync](/zh-CN/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobasync.md)
- [XblTitleStorageDeleteBlobAsync](/zh-CN/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedeleteblobasync.md)
- [获取 Title Storage blob 元数据](/zh-CN/services/xbox-services/storage/title-storage/how-to/live-getting-title-storage-blob-metadata.md)