> ## 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.

# XStoreDownloadPackageUpdatesAsync

> XStoreDownloadPackageUpdatesAsync

# XStoreDownloadPackageUpdatesAsync

> [!NOTE]
>
> 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](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md).

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

```cpp theme={null}
HRESULT XStoreDownloadPackageUpdatesAsync(  
         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 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)](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. Consulte [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) para obter mais informações.

### Valor retornado

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

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](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md). Para recuperar o resultado desta função, chame [XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md) após chamar esta função. Consulte [XStoreQueryGameAndDlcPackageUpdatesAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync.md) 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](https://docs.xbox.com/pt-BR/reference/system/xstore/xstore_members.md)\
[XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)\
[XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md)


## Related topics

- [XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.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)
- [XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md)
- [XStoreDownloadAndInstallPackageUpdatesResult](https://docs.xbox.com/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult.md)