Pular para o conteúdo principal

XStoreDownloadAndInstallPackageUpdatesAsync

Baixa e instala atualizações para os pacotes da loja especificados.

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 cadeias de caracteres de identificadores de pacote. Um identificador de pacote identifica exclusivamente 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. Para obter mais informações, consulte XAsyncBlock.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

Esta função baixa e instala atualizações para os pacotes da loja especificados.
Quando você chama esta função e ela encontra atualizações para o jogo, o jogo é encerrado imediatamente para permitir que a instalação ocorra.
Para recuperar os resultados do download e da instalação da atualização, chame XStoreDownloadAndInstallPackageUpdatesResult após chamar esta função. Para obter um exemplo de uso, consulte XStoreQueryGameAndDlcPackageUpdatesAsync. Quando você chama esta API de um jogo em execução, os downloads são de alta prioridade e vão para o início da fila, na ordem especificada no parâmetro storeIds.

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

Documentação conceitual

Confira também

XStore
XStoreDownloadAndInstallPackageUpdatesResult
Última modificação em 19 de outubro de 2026