Skip to main content

XPackageUnregisterPackageInstalled

Annule l’inscription d’un rappel d’installation de package inscrit précédemment.

Syntaxe

Paramètres

token   _In_
Type : XTaskQueueRegistrationToken
Jeton retourné par XPackageRegisterPackageInstalled. wait   _In_
Type : bool
Indique s’il faut bloquer jusqu’à ce que tous les rappels en attente soient terminés.

Valeur de retour

Type : bool Si wait a la valeur false et que l’annulation de l’inscription est en attente, retourne false. Sinon, retourne true.

Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
L’annulation de l’inscription d’une notification se comporte comme suit :
  • L’annulation de l’inscription supprime de l’ensemble des rappels inscrits le rappel associé au jeton.
  • Si aucun rappel ne s’exécute pour ce jeton de rappel, l’appel retourne true.
  • Si des rappels s’exécutent et que wait a la valeur true, l’appel bloque jusqu’à ce que le rappel en cours d’exécution soit terminé.
  • Si des rappels s’exécutent et que wait a la valeur false, l’appel ne bloque pas, mais retourne false. Une fois le rappel du jeton terminé, l’inscription du jeton est automatiquement annulée.
Ce mécanisme permet les modèles de codage suivants :
  1. Vous pouvez bloquer lors de l’annulation de l’inscription pour vous assurer que vos rappels ne sont jamais appelés après un appel d’annulation de l’inscription.
  2. Vous pouvez choisir de ne pas bloquer. Pour vous assurer que vos rappels sont terminés avant de supprimer des données, appelez périodiquement l’annulation de l’inscription avec la valeur false pour wait. Lorsqu’elle retourne finalement true, tous vos rappels sont terminés et vous pouvez supprimer l’état.
  3. S’il importe peu à votre rappel d’être appelé pendant un appel d’annulation de l’inscription, vous pouvez simplement passer false pour wait et ignorer la valeur de retour.
L’exemple de code suivant illustre l’utilisation de XPackageUnregisterPackageInstalled :

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
Comment créer et utiliser des packages de contenu téléchargeable (DLC) pour PC et XBOX One
Last modified on October 6, 2026