Skip to main content

XPackageUnregisterPackageInstalled

Désinscrit un rappel d’installation de package précédemment inscrit.

Syntaxe

Paramètres

token   _In_
Type : XTaskQueueRegistrationToken
Jeton renvoyé 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 la désinscription est en attente, renvoie false. Sinon, renvoie true.

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
La désinscription d’une notification se comporte comme suit :
  • La désinscription supprime le rappel associé au jeton de l’ensemble des rappels inscrits.
  • Si aucun rappel n’est en cours d’exécution pour ce jeton de rappel, l’appel renvoie true.
  • Si des rappels sont en cours d’exécution et que wait a la valeur true, l’appel est bloqué jusqu’à ce que le rappel en cours d’exécution soit terminé.
  • Si des rappels sont en cours d’exécution et que wait a la valeur false, l’appel n’est pas bloqué mais renvoie false. Une fois le rappel du jeton terminé, le jeton est automatiquement désinscrit.
Ce mécanisme permet les modèles de codage suivants :
  1. Vous pouvez bloquer lors de la désinscription pour vous assurer que vos rappels ne sont jamais invoqués après un appel de désinscription.
  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 la désinscription avec false pour wait. Lorsqu’elle renvoie finalement true, tous vos rappels sont terminés et vous pouvez supprimer l’état.
  3. Si peu importe à votre rappel d’être invoqué pendant un appel de désinscription, 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