Skip to main content

XUserUnregisterForChangeEvent

Désinscrit un rappel de modification d’utilisateur précédemment inscrit.

Syntaxe

Paramètres

token   _In_
Type : XTaskQueueRegistrationToken
Jeton renvoyé par XUserRegisterForChangeEvent, qui identifie le rappel à désinscrire. 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 Renvoie false si wait a la valeur false et que la désinscription est en attente. Renvoie true dans les autres cas.

Remarques

Cette fonction ne peut pas être appelée en toute sécurité sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
Désinscription d’une notification : 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 le 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 bloque 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 ne bloque pas mais renvoie false. Une fois le rappel associé au 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 garantir que vos rappels ne sont jamais invoqués après un appel de désinscription.
  2. Vous pouvez choisir de ne pas bloquer. Si vous devez vous assurer que vos rappels sont terminés avant de supprimer des données, vous pouvez appeler périodiquement la désinscription avec false pour wait. Lorsqu’elle renvoie enfin true, tous vos rappels sont terminés et vous pouvez supprimer l’état.
  3. Si un appel de désinscription n’invoque pas le rappel, vous pouvez simplement passer false pour wait et ignorer la valeur de retour.
Pour inscrire un rappel de modification d’utilisateur, appelez XUserRegisterForChangeEvent. L’énumération XUserChangeEvent spécifie un type d’événement de modification. XUserChangeEventCallback est un rappel pour un événement de modification d’utilisateur. L’exemple suivant montre comment gérer les événements de modification d’utilisateur.

Configuration requise

En-tête : XUser.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XUser XUserRegisterForChangeEvent XUserChangeEvent XUserChangeEventCallback
Last modified on October 6, 2026