Skip to main content

XPackageEnumeratePackages

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

Syntaxe

Paramètres

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

Valeur de retour

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

Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Utilisez XPackageEnumeratePackages pour trouver les packages qui sont déjà installés, ou en cours d’installation, et 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 au moyen 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 pour permettre à l’identificateur du package de surveiller la progression de l’installation. Il n’existe aucune notification générique de file d’attente d’installation; l’intention est d’utiliser XPackageEnumeratePackages pour afficher et suivre les éléments en cours. Il n’existe pas non plus d’API pour arrêter, démarrer ou annuler une installation. Du point de vue d’un jeu, l’installation devrait 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, selon la valeur de XPackageEnumerationScope, sera : La sortie de l’API, lorsqu’elle est appelée avec la valeur XPackageKind::Content, selon la valeur de XPackageEnumerationScope, sera : 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
Last modified on October 6, 2026