> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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](/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync).
</Note>

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](/pt-BR/reference/system/xstore/functions/xstorecreatecontext).

*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)](/pt-BR/publishing/xstore-commerce/xstore-dlc).

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

O número de identificadores em **packageIdentifiers**.

*async*   \_Inout\_\
Tipo: [XAsyncBlock\*](/pt-BR/reference/system/xasync/structs/xasyncblock)

Um [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) que define o trabalho assíncrono que está sendo feito. O [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Consulte [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) 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](/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync). Para recuperar o resultado desta função, chame [XStoreDownloadPackageUpdatesResult](/pt-BR/reference/system/xstore/functions/xstoredownloadpackageupdatesresult) após chamar esta função. Consulte [XStoreQueryGameAndDlcPackageUpdatesAsync](/pt-BR/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync) 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](/pt-BR/reference/system/xstore/xstore_members)\
[XStoreDownloadPackageUpdatesResult](/pt-BR/reference/system/xstore/functions/xstoredownloadpackageupdatesresult)\
[XStoreDownloadAndInstallPackageUpdatesAsync](/pt-BR/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync)


## Related topics

- [XStoreDownloadPackageUpdatesAsync](/reference/system/xstore/functions/xstoredownloadpackageupdatesasync.md)
- [XStoreDownloadPackageUpdatesResult](/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)
- [XStore](/reference/system/xstore/xstore_members.md)
- [XStoreDownloadAndInstallPackageUpdatesAsync](/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md)
- [XStoreDownloadAndInstallPackageUpdatesResult](/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult.md)