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

# XPackageMountWithUiAsync

> XPackageMountWithUiAsync

# XPackageMountWithUiAsync

Monte de manière asynchrone l'installation du contenu spécifié et renvoie un handle de montage vers celui-ci.
Affiche l'interface utilisateur de consentement parental si le contenu fait l'objet d'une restriction d'âge en fonction des paramètres parentaux de tous les utilisateurs connectés.

## Syntaxe

```cpp theme={null}
HRESULT XPackageMountWithUiAsync(
  const char * packageIdentifier,
  XAsyncBlock * async
) noexcept;
```

### Paramètres

*packageIdentifier*  \_In\_z\_\
Type : const char \*

Chaîne qui identifie de manière unique le package installé sur le disque.
Passez le champ packageIdentifier de la structure [XPackageDetails](/fr/reference/system/xpackage/structs/xpackagedetails) renvoyée par [XPackageEnumerationCallback](/fr/reference/system/xpackage/functions/xpackageenumerationcallback).
Pour plus d'informations sur les identificateurs de package, consultez [Gérer et octroyer des licences pour le contenu téléchargeable (DLC)](/fr/publishing/xstore-commerce/xstore-dlc).

*async*  \_Inout\_\
Type : XAsyncBlock \*

**XAsyncBlock** permettant de surveiller l'état de l'appel asynchrone.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Cette API affiche une invite de consentement parental à l'utilisateur si elle monte du contenu qui n'est pas adapté à l'âge de tous les utilisateurs connectés.
Si un utilisateur adulte accorde le consentement parental dans l'invite, l'API tente de monter le package.
Si un utilisateur adulte refuse le consentement parental dans l'invite, l'API ne parvient pas à monter le package.

Cette API appelle automatiquement [XStoreAcquireLicenseForPackageAsync](/fr/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) / [Result](/fr/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult) et [XStoreIsLicenseValid](/fr/reference/system/xstore/functions/xstoreislicensevalid).
Si l'API ne parvient pas à acquérir une licence valide pour le DLC, le montage échoue.

Dans cet exemple de code, un jeu affiche le DLC en noir et blanc si le contenu fait l'objet d'une restriction d'âge.
Du code externe du jeu appelle `MountDlc` lorsque l'utilisateur sélectionne un élément de DLC à utiliser.

```cpp theme={null}
extern void RenderDlc(const char* packageId, const char* displayName, bool monochrome); 

void ShowDlc() 
{ 
// Enumerate all DLC for the game and render it to the user 
XPackageEnumeratePackages(XPackageKind::Content, XPackageEnumerationScope::ThisAndRelated, nullptr,
 [](void*, const XPackageDetails* details) 
  {     
        RenderDlc(details->packageIdentifier,
                  details->displayName, 
                  details->ageRestricted);
  }); 
} 

 HRESULT MountDlc(const char* packageId, XPackageMountHandle* handle)
 {  
    XAsync async{};  
    RETURN_IF_FAILED(XPackageMountWithUiAsync(packageId, &async));
    RETURN_IF_FAILED(XAsyncGetStatus(&async, true));
    RETURN_IF_FAILED(XPackageMountWithUiResult(&async, handle));  
    return S_OK; 
} 
```

## Configuration requise

**En-tête :** XPackage.h

**Bibliothèque :** xgameruntime.lib

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

## Documentation conceptuelle

* [Prise en charge des jeux en tant que service (GaaS)](/fr/build/core-features/common/packaging/supporting-games-as-a-service)

## Voir aussi

[XPackageMountWithUiResult](/fr/reference/system/xpackage/functions/xpackagemountwithuiresult)
[XPackage](/fr/reference/system/xpackage/xpackage_members)\
[XPackageEnumeratePackages](/fr/reference/system/xpackage/functions/xpackageenumeratepackages)\
[XPackageEnumerationCallback](/fr/reference/system/xpackage/functions/xpackageenumerationcallback)\
[XPackageDetails](/fr/reference/system/xpackage/structs/xpackagedetails)\
[XPackageGetMountPath](/fr/reference/system/xpackage/functions/xpackagegetmountpath)\
[XPackageGetMountPathSize](/fr/reference/system/xpackage/functions/xpackagegetmountpathsize)\
[Comment créer et utiliser des packages de contenu téléchargeable (DLC) pour PC et XBOX One](/fr/build/core-features/common/packaging/packaging-downloadable-content-dlc)


## Related topics

- [XPackageMountWithUiAsync](/reference/system/xpackage/functions/xpackagemountwithuiasync.md)
- [[DEPRECATED] XPackageMount](/reference/system/xpackage/functions/xpackagemount.md)
- [[EN DESUSO] XPackageMount](/es/reference/system/xpackage/functions/xpackagemount.md)