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

# XblTitleStorageUploadBlobAsync

> XblTitleStorageUploadBlobAsync

# XblTitleStorageUploadBlobAsync

Carrega dados de blob no armazenamento de título.

## Sintaxe

```cpp theme={null}
HRESULT XblTitleStorageUploadBlobAsync(  
         XblContextHandle xboxLiveContext,  
         XblTitleStorageBlobMetadata blobMetadata,  
         const uint8_t* blobBuffer,  
         size_t blobBufferCount,  
         XblTitleStorageETagMatchCondition etagMatchCondition,  
         size_t preferredUploadBlockSize,  
         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)

Contém as propriedades necessárias para carregar o buffer no armazenamento de título. Os carregamentos exigem, no mínimo, uma ID de configuração de serviço, um caminho de blob, um tipo de blob e um tipo de armazenamento.

*blobBuffer*   \_In\_\
Tipo: uint8\_t\*

O buffer que contém os dados de blob a serem carregados. Esse buffer deve estar disponível durante toda a operação assíncrona. Os clientes não devem modificar o buffer enquanto um carregamento estiver em andamento.

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

O comprimento 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 os dados de blob devem ser carregados.

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

O tamanho de bloco de carregamento preferencial, em bytes, para blobs binários. Os blobs binários serão carregados em várias partes desse tamanho caso o excedam. Tamanhos maiores são preferidos pelo serviço. Se ocorrerem tempos limite, o aplicativo deverá tentar novamente com um tamanho menor. O tamanho do bloco deve estar no intervalo de 1K a 4MB. Este método usará um tamanho padrão se esse parâmetro não estiver dentro do intervalo aceitável. O tamanho mínimo atual é de 1024 bytes, o tamanho máximo é de 4194304 bytes e o tamanho padrão é de 262144 bytes. (Opcional)

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

AsyncBlock alocado pelo chamador.

### Valor retornado

Tipo: HRESULT

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

## Chamada REST

V1 PUT json/users/xuid({xuid})/scids/{scid}/data/{path},{type}\
V1 PUT global/scids/{scid}/data/{path},{type}\
V1 PUT 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

- [XblTitleStorageUploadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobasync.md)
- [Uploading a blob to Title Storage](/services/xbox-services/storage/title-storage/how-to/live-uploading-title-storage-blob.md)
- [XblTitleStorageUploadBlobResult](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobresult.md)