> ## 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 데이터를 다운로드합니다.

## Syntax

```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  
)  
```

### Parameters

*xboxLiveContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다.

*blobMetadata*   \_In\_\
Type: [XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata)

다운로드할 타이틀 저장소 blob의 blob 메타데이터입니다.

*blobBuffer*   \_Out\_writes\_(blobBufferCount)\
Type: uint8\_t\*

다운로드한 blob 데이터를 다시 전달하는 호출자가 할당한 버퍼입니다. 이 버퍼는 다운로드하는 blob을 저장할 수 있을 만큼 충분히 커야 합니다. 필요한 경우 blob 메타데이터를 가져와 버퍼에 필요한 길이를 조회할 수 있습니다.

*blobBufferCount*   \_In\_\
Type: size\_t

blobBuffer의 길이입니다.

*etagMatchCondition*   \_In\_\
Type: [XblTitleStorageETagMatchCondition](/reference/live/xsapi-c/title_storage_c/enums/xbltitlestorageetagmatchcondition)

blob 다운로드 여부를 결정하는 데 사용되는 ETag 일치 조건입니다.

*selectQuery*   \_In\_opt\_z\_\
Type: char\*

필터링할 ConfigStorage 필터 문자열 또는 JSONStorage json 속성 이름 문자열입니다. (선택 사항)

*preferredDownloadBlockSize*   \_In\_\
Type: size\_t

바이너리 blob의 기본 다운로드 블록 크기(바이트)입니다. 기본 크기를 사용하려면 0을 전달합니다. (선택 사항)

*async*   \_In\_\
Type: XAsyncBlock\*

호출자가 할당한 AsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

## Remarks

결과를 얻으려면 AsyncBlock 콜백 내부 또는 AsyncBlock이 완료된 후에 [XblTitleStorageDownloadBlobResult](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult)를 호출합니다. blobBuffer가 blob 데이터를 저장할 만큼 충분한 용량을 갖지 않는 경우 이 메서드는 E\_NOT\_SUFFICIENT\_BUFFER(0x8007007A)를 반환합니다.

## REST Call

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}

## Requirements

**Header:** title\_storage\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

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


## Related topics

- [XblTitleStorageDownloadBlobResult](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult.md)
- [Title Storage에서 blob 다운로드](/ko/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [XblTitleStorageUploadBlobAsync](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobasync.md)
- [XblTitleStorageDeleteBlobAsync](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedeleteblobasync.md)
- [XblTitleStorageUploadBlobResult](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobresult.md)