Skip to main content

XStoreQueryPackageUpdatesAsync

Recupera uma lista de atualizações disponíveis para os pacotes especificados no argumento. Use essa lista para baixar e instalar as atualizações.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o 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, confira 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. Use o XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada. Para obter mais informações, confira XAsyncBlock.

Valor retornado

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

Comentários

Para obter o identificador de pacote do jogo em execução no momento, use XPackageGetCurrentProcessPackageIdentifier ou use XPackageEnumeratePackages para obter os identificadores de pacote de DLCs e jogos relacionados. Para recuperar a lista de atualizações disponíveis e o resultado da execução desta função, chame XStoreQueryPackageUpdatesResult após chamar esta função. Para obter o número de atualizações a serem recuperadas, chame XStoreQueryPackageUpdatesResultCount após chamar esta função. A função de contagem de resultados é importante, pois permite determinar o tamanho apropriado da matriz a ser passada para a função de resultado. O snippet de código a seguir mostra um exemplo de recuperação de atualizações do jogo e opcionais para os pacotes especificados.

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
XStoreQueryPackageUpdatesResult
XStoreQueryPackageUpdatesResultCount
Last modified on October 6, 2026