Skip to main content

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

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 renvoyée par XPackageEnumerationCallback. Pour plus d’informations sur les identificateurs de package, consultez Gérer et octroyer des licences pour le contenu téléchargeable (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 / Result et 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.

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

Voir aussi

XPackageMountWithUiResult XPackage
XPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
Comment créer et utiliser des packages de contenu téléchargeable (DLC) pour PC et XBOX One
Last modified on October 6, 2026