Skip to main content

​
XStoreDownloadPackageUpdatesAsync

Esta API não funciona como esperado, porque as atualizações no XBOX são instaladas à medida que são baixadas. Se a atualização for para o jogo, o jogo será encerrado. Se a atualização for para um DLC, o jogo será encerrado se o pacote de DLC estiver montado no momento.Em vez disso, use XStoreDownloadAndInstallPackageUpdatesAsync.
Baixa atualizações para os pacotes especificados sem instalá-las. Isso permite que o jogo controle quando a instalação das atualizações ocorre, para evitar que o jogo seja desligado enquanto o usuário está jogando.

​
Sintaxe

​
Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle O identificador de contexto da loja do usuário retornado por XStoreCreateContext. packageIdentifiers   _In_z_count_(packageIdentifiersCount)
Tipo: char** Lista de identificadores de pacote. Um identificador de pacote é uma cadeia de caracteres de ID exclusiva para um pacote da Microsoft Store. Para obter mais informações sobre identificadores de pacote, consulte Gerenciar e licenciar conteúdo para download (DLC). packageIdentifiersCount   _In_
Tipo: size_t O número de identificadores em packageIdentifiers. async   _Inout_
Tipo: XAsyncBlock* Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Consulte XAsyncBlock para obter mais informações.

​
Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedida; caso contrário, retorna um código de erro.

​
Comentários

Esta função apenas baixa uma atualização, mas não a instala. Para baixar e instalar uma atualização em uma única chamada, use a função XStoreDownloadAndInstallPackageUpdatesAsync. Para recuperar o resultado desta função, chame XStoreDownloadPackageUpdatesResult após chamar esta função. Consulte XStoreQueryGameAndDlcPackageUpdatesAsync para obter um exemplo de uso. Quando esta API é chamada de um jogo em execução, os downloads são considerados de alta prioridade e vão para o início da fila, na ordem em que são especificados no parâmetro storeIds desta API.

​
Requisitos

Cabeçalho: XStore.h (incluído em XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

​
Confira também

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync
Last modified on October 6, 2026