Passer au contenu principal

XPackageEnumeratePackages

Recherche les packages déjà installés, ou en cours d’installation, qui sont liés au processus appelant.

Syntaxe

Paramètres

kind   _In_
Type : XPackageKind
Type des packages d’installation à énumérer. scope   _In_
Type : XPackageEnumerationScope
Étendue des packages d’installation. context   _In_opt_
Type : void*
Contexte à transmettre au rappel spécifié dans le paramètre callback. callback   _In_
Type : XPackageEnumerationCallback*
Rappel à appeler à la fin de l’opération.

Valeur renvoyée

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

Cette fonction ne peut pas être appelée en toute sécurité sur un thread à contrainte de temps. Pour plus d’informations, consultez Threads à contrainte de temps.
Utilisez XPackageEnumeratePackages pour rechercher les packages déjà installés, ou en cours d’installation, qui sont liés au processus appelant. Cette fonction peut trouver des packages de contenu ainsi que des packages d’application. Elle fournit des détails sur une installation par le biais d’une structure XPackageDetails. Si le package est toujours en cours d’installation, la propriété installing est définie sur true et vous pouvez créer un moniteur d’installation afin d’utiliser l’identificateur du package pour surveiller la progression de l’installation. Il n’existe pas de notifications génériques de file d’attente d’installation ; l’objectif est d’utiliser XPackageEnumeratePackages pour afficher et suivre les éléments en cours. Il n’existe pas non plus d’API permettant d’arrêter, de démarrer ou d’annuler une installation. Du point de vue d’un jeu, l’installation doit se gérer d’elle-même. Les erreurs font automatiquement l’objet de nouvelles tentatives et sont invisibles pour le jeu. La sortie de l’API, lorsqu’elle est appelée avec la valeur XPackageKind::Game, dépend de la valeur XPackageEnumerationScope comme suit : La sortie de l’API, lorsqu’elle est appelée avec la valeur XPackageKind::Content, dépend de la valeur XPackageEnumerationScope comme suit : Exemple :

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

XPackage
Hubs de jeux de franchise
Comment créer et utiliser des packages de contenu téléchargeable (DLC) pour PC et XBOX One
Dernière modification le 19 octobre 2026