> ## 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

從 Title Storage 下載 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](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

使用 XblContextCreateHandle 建立的 Xbox Live 內容控制代碼。

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

要下載之 Title Storage Blob 的 Blob 中繼資料。

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

由呼叫端配置的緩衝區，用來傳回下載的 Blob 資料。此緩衝區必須夠大，才能儲存正在下載的 Blob。必要時，可以透過取得 Blob 中繼資料來擷取緩衝區所需的長度。

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

blobBuffer 的長度。

*etagMatchCondition*   \_In\_\
類型：[XblTitleStorageETagMatchCondition](/zh-TW/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](/zh-TW/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](/zh-TW/reference/live/xsapi-c/title_storage_c/title_storage_c_members)


## Related topics

- [XblTitleStorageDownloadBlobResult](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult.md)
- [從遊戲儲存空間下載 Blob](/zh-TW/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [XblTitleStorageDeleteBlobAsync](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedeleteblobasync.md)
- [XblTitleStorageUploadBlobAsync](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobasync.md)
- [XblTitleStorageUploadBlobResult](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobresult.md)