Skip to main content

​
XNetworkingUnregisterConnectivityHintChanged

Annule l’inscription d’une fonction de rappel qui a été inscrite avec XNetworkingRegisterConnectivityHintChanged.

​
Syntaxe

​
Paramètres

token   _In_
Type : XTaskQueueRegistrationToken Jeton retourné par XNetworkingRegisterConnectivityHintChanged. 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 Retourne false si wait a la valeur false et que l’appel d’annulation d’inscription est en attente. Retourne true dans les autres cas.

​
Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread où le temps est critique. Pour plus d’informations, consultez Threads où le temps est critique.
Cette fonction effectue les actions suivantes :
  • Le rappel associé au jeton est retiré de l’ensemble des rappels inscrits.
  • Si aucun rappel n’est en cours d’exécution pour ce jeton de rappel, l’appel retourne 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 retourne false. Lorsque le rappel associé au jeton est terminé, l’inscription du jeton est automatiquement annulée.
Cette fonction ne doit pas être appelée à partir d’un XNetworkingConnectivityHintChangedCallback si wait a la valeur true, car cela provoquerait un interblocage.
Ce mécanisme permet les modèles de codage suivants :
  • 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 d’inscription.
  • 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 cette fonction avec wait défini à false. Lorsqu’elle retourne finalement true, tous vos rappels sont terminés et vous pouvez supprimer l’état.
  • Si votre rappel ne se soucie pas d’être appelé pendant un appel d’annulation d’inscription, vous pouvez passer false pour wait et ignorer la valeur de retour.

​
Configuration requise

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

​
Documentation conceptuelle

​
Voir aussi

XNetworkingRegisterConnectivityHintChanged
XNetworkingGetConnectivityHint
Initialisation et connectivité du réseau
XNetworking
Last modified on October 6, 2026