> ## 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](/ja-jp/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult.md)
- [Title Storage から blob をダウンロードする](/ja-jp/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [XblTitleStorageDeleteBlobAsync](/ja-jp/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedeleteblobasync.md)
- [XblTitleStorageUploadBlobAsync](/ja-jp/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobasync.md)
- [XblTitleStorageGetBlobMetadataAsync](/ja-jp/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync.md)