Skip to main content

XblTitleStorageDownloadBlobAsync

Baixa dados de blob do armazenamento do título.

Sintaxe

Parâmetros

xboxLiveContext   _In_
Tipo: XblContextHandle
Um identificador de contexto do Xbox Live criado com XblContextCreateHandle. blobMetadata   _In_
Tipo: 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
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 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()/scids//data/,
V1 GET json/users/xuid()/scids//data/,
V1 GET global/scids//data/,
V1 GET sessions//scids//data/,

Requisitos

Cabeçalho: title_storage_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

title_storage_c
Last modified on October 6, 2026