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

Baixa dados de blob do armazenamento do título.

## Sintaxe

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

### Parâmetros

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

Um identificador de contexto do Xbox Live criado com XblContextCreateHandle.

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

Os metadados do blob do armazenamento do título a ser baixado.

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

Um buffer alocado pelo chamador que retorna os dados do blob baixado. Esse buffer precisa ser grande o suficiente para armazenar o blob que está sendo baixado. Se necessário, o tamanho exigido para o buffer pode ser recuperado obtendo os metadados do blob.

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

O tamanho de blobBuffer.

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

A condição de correspondência de ETag usada para determinar se o blob deve ser baixado.

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

Cadeia de caracteres de filtro do ConfigStorage ou cadeia de caracteres de nome de propriedade json do JSONStorage para filtrar. (Opcional)

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

O tamanho de bloco de download preferencial, em bytes, para blobs binários. Passe 0 para usar o tamanho padrão. (Opcional)

*async*   \_In\_\
Tipo: XAsyncBlock\*

AsyncBlock alocado pelo chamador.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Comentários

Para obter o resultado, chame [XblTitleStorageDownloadBlobResult](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult) dentro do retorno de chamada do AsyncBlock ou após a conclusão do AsyncBlock. Este método retornará E\_NOT\_SUFFICIENT\_BUFFER (0x8007007A) se o blobBuffer não tiver capacidade suficiente para armazenar os dados do blob.

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

## Requisitos

**Cabeçalho:** title\_storage\_c.h

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

## Confira também

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


## Related topics

- [XblTitleStorageDownloadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [Downloading a blob from Title Storage](/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [XblTitleStorageDownloadBlobResult](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult.md)