Skip to main content

XStoreDownloadAndInstallPackagesAsync

Baixa e instala os pacotes da loja especificados.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja do usuário retornado por XStoreCreateContext. storeIds   _In_z_count_(storeIdsCount)
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). storeIdsCount   _In_
Tipo: size_t
O número de IDs em storeIds. 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 Código de êxito ou de erro HRESULT.

Comentários

Para recuperar o resultado do download e da instalação desta função, chame XStoreDownloadAndInstallPackagesResult após chamar esta função. Para recuperar o número de itens baixados e instalados, chame XStoreDownloadAndInstallPackagesResultCount após chamar esta função. A função de contagem de resultados é importante, pois permitirá que você determine o tamanho apropriado da matriz a ser passada para a função de resultado. 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. O snippet de código a seguir mostra um exemplo de download e instalação de pacotes da loja.

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
XStoreDownloadAndInstallPackagesResult
XStoreDownloadAndInstallPackagesResultCount
Last modified on October 6, 2026