> ## 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, celui-ci se termine.
  Si la mise à jour concerne un DLC, le jeu se termine si le package de DLC est actuellement monté.

  Utilisez plutôt [XStoreDownloadAndInstallPackageUpdatesAsync](/fr/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 s'arrête 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

Handle de contexte de Store de l'utilisateur, renvoyé par [XStoreCreateContext](/fr/reference/system/xstore/functions/xstorecreatecontext).

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

Liste d'identificateurs de package.
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 package, consultez [Gérer et accorder des licences pour le contenu téléchargeable (DLC)](/fr/publishing/xstore-commerce/xstore-dlc).

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

Nombre d'identificateurs dans **packageIdentifiers**.

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

[XAsyncBlock](/fr/reference/system/xasync/structs/xasyncblock) définissant le travail asynchrone en cours. Le [XAsyncBlock](/fr/reference/system/xasync/structs/xasyncblock) peut être utilisé pour interroger l'état de l'appel et récupérer ses résultats. Pour plus d'informations, consultez [XAsyncBlock](/fr/reference/system/xasync/structs/xasyncblock).

### Valeur de retour

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

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

## Remarques

Cette fonction télécharge uniquement 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/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync). Pour récupérer le résultat de cette fonction, appelez [XStoreDownloadPackageUpdatesResult](/fr/reference/system/xstore/functions/xstoredownloadpackageupdatesresult) après avoir appelé cette fonction. Pour obtenir un exemple d'utilisation, consultez [XStoreQueryGameAndDlcPackageUpdatesAsync](/fr/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync).

Lorsque cette API est appelée depuis un jeu en cours d'exécution, les téléchargements sont considérés comme prioritaires et sont placés au début de la file d'attente, dans l'ordre dans lequel 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/reference/system/xstore/xstore_members)\
[XStoreDownloadPackageUpdatesResult](/fr/reference/system/xstore/functions/xstoredownloadpackageupdatesresult)\
[XStoreDownloadAndInstallPackageUpdatesAsync](/fr/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync)


## Related topics

- [XStoreDownloadPackageUpdatesAsync](/reference/system/xstore/functions/xstoredownloadpackageupdatesasync.md)
- [XStoreDownloadPackageUpdatesResult](/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)