> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreDownloadAndInstallPackageUpdatesAsync

> XStoreDownloadAndInstallPackageUpdatesAsync

# XStoreDownloadAndInstallPackageUpdatesAsync

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

## Sintaxe

```cpp theme={null}
HRESULT XStoreDownloadAndInstallPackageUpdatesAsync(  
         const XStoreContextHandle storeContextHandle,  
         const char** packageIdentifiers,  
         size_t packageIdentifiersCount,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*storeContextHandle*   \_In\_\
Tipo: XStoreContextHandle

O identificador de contexto da loja do usuário retornado por [XStoreCreateContext](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorecreatecontext.md).

*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)](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-dlc.md).

*packageIdentifiersCount*   \_In\_\
Tipo: size\_t

O número de identificadores em `packageIdentifiers`.

*async*   \_Inout\_\
Tipo: [XAsyncBlock\*](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md)

Um [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) que define o trabalho assíncrono que está sendo feito. O [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Para obter mais informações, consulte [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md).

### Valor retornado

Tipo: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Código de êxito ou de erro HRESULT.

## Comentários

Esta função baixa e instala atualizações para os pacotes da loja especificados.

> [!NOTE]
>
> 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](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult.md) após chamar esta função.
Para obter um exemplo de uso, consulte [XStoreQueryGameAndDlcPackageUpdatesAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync.md).

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

* [Verificando se há atualizações](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-checking-updates.md)

## Confira também

[XStore](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)\
[XStoreDownloadAndInstallPackageUpdatesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult.md)


## Related topics

- [XStoreDownloadAndInstallPackageUpdatesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult.md)
- [XStoreDownloadPackageUpdatesAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadpackageupdatesasync.md)
- [Verificando atualizações](https://docs.xbox.com/pt-BR/publishing/xstore-commerce/xstore-checking-updates.md)
- [XStore (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)
- [Usar wrappers C# para APIs do GDK no seu projeto do Unity](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)