Skip to main content

​
XNetworkingUnregisterConnectivityHintChanged

Désinscrit une fonction de rappel qui a été inscrite avec XNetworkingRegisterConnectivityHintChanged.

​
Syntaxe

​
Paramètres

token   _In_
Type : XTaskQueueRegistrationToken Jeton renvoyé 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 Renvoie false si wait a la valeur false et que l’appel de 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 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 supprimé 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 bloque jusqu’à la fin du rappel en cours d’exécution.
  • Si des rappels sont en cours d’exécution et que wait a la valeur false, l’appel ne bloque pas mais renvoie false. Lorsque le rappel du jeton est terminé, le jeton est automatiquement désinscrit.
Cette fonction ne doit pas être appelée depuis 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 la désinscription pour vous assurer que vos rappels ne sont jamais appelés après un appel de désinscription.
  • 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 régulièrement cette fonction avec wait défini sur false. Lorsqu’elle renvoie 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 de désinscription, 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é réseau
XNetworking
Last modified on October 6, 2026