> ## 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>
  Cette API ne fonctionne pas comme prévu, car les mises à jour sur XBOX sont installées au fur et à mesure de leur téléchargement.
  Si la mise à jour concerne le jeu, le jeu se terminera.
  Si la mise à jour concerne du DLC, le jeu se terminera si le package de DLC est actuellement monté.

  Utilisez plutôt [XStoreDownloadAndInstallPackageUpdatesAsync](/fr-CA/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync).
</Note>

Télécharge les mises à jour des packages spécifiés sans les installer. Cela permet à votre jeu de contrôler le moment de l'installation des mises à jour afin d'éviter que le jeu ne se ferme pendant que l'utilisateur joue.

## Syntaxe

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

### Paramètres

*storeContextHandle*   \_In\_\
Type : XStoreContextHandle

Le handle de contexte de magasin de l'utilisateur retourné par [XStoreCreateContext](/fr-CA/reference/system/xstore/functions/xstorecreatecontext).

*packageIdentifiers*   \_In\_z\_count\_(packageIdentifiersCount)\
Type : char\*\*

Liste d'identificateurs de packages.
Un identificateur de package est une chaîne d'ID unique pour un package du Microsoft Store. Pour plus d'informations sur les identificateurs de packages, consultez [Gérer et octroyer des licences pour le contenu téléchargeable (DLC)](/fr-CA/publishing/xstore-commerce/xstore-dlc).

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

Le nombre d'identificateurs dans **packageIdentifiers**.

*async*   \_Inout\_\
Type : [XAsyncBlock\*](/fr-CA/reference/system/xasync/structs/xasyncblock)

Un [XAsyncBlock](/fr-CA/reference/system/xasync/structs/xasyncblock) qui définit le travail asynchrone en cours. Le [XAsyncBlock](/fr-CA/reference/system/xasync/structs/xasyncblock) peut servir à interroger l'état de l'appel et à récupérer les résultats de l'appel. Pour plus d'informations, consultez [XAsyncBlock](/fr-CA/reference/system/xasync/structs/xasyncblock).

### Valeur de retour

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

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur.

## Remarques

Cette fonction télécharge seulement une mise à jour, mais ne l'installe pas. Pour télécharger et installer une mise à jour en un seul appel, utilisez la fonction [XStoreDownloadAndInstallPackageUpdatesAsync](/fr-CA/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync). Pour récupérer le résultat de cette fonction, appelez [XStoreDownloadPackageUpdatesResult](/fr-CA/reference/system/xstore/functions/xstoredownloadpackageupdatesresult) après avoir appelé cette fonction. Consultez [XStoreQueryGameAndDlcPackageUpdatesAsync](/fr-CA/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync) pour un exemple d'utilisation.

Lorsque cette API est appelée à partir d'un jeu en cours d'exécution, les téléchargements sont considérés comme hautement prioritaires et sont placés au début de la file d'attente, dans l'ordre où ils sont spécifiés dans le paramètre storeIds de cette API.

## Configuration requise

**En-tête :** XStore.h (inclus dans XGameRuntime.h)

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[XStore](/fr-CA/reference/system/xstore/xstore_members)\
[XStoreDownloadPackageUpdatesResult](/fr-CA/reference/system/xstore/functions/xstoredownloadpackageupdatesresult)\
[XStoreDownloadAndInstallPackageUpdatesAsync](/fr-CA/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)