CancelMibChangeNotify2, fonction (netioapi.h)

Article
03/04/2024

La fonction CancelMibChangeNotify2 annule l’inscription des notifications de modification pour les modifications d’interface IP, les modifications d’adresse IP, les modifications d’itinéraire IP, les modifications de port Teredo et lorsque la table d’adresses IP de monodiffusion est stable et peut être récupérée.

Syntaxe

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

Paramètres

[in] NotificationHandle

Handle retourné à partir d’une fonction d’inscription ou de récupération de notification pour indiquer la notification à annuler.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_INVALID_PARAMETER	Un paramètre non valide a été transmis à la fonction. Cette erreur est retournée si le paramètre NotificationHandle était un pointeur NULL .
Autres	Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

La fonction CancelMibChangeNotify2 est définie sur Windows Vista et versions ultérieures.

The
La fonction CancelMibChangeNotify2 annule l’inscription d’une notification de modification précédemment demandée pour les modifications de l’interface IP, les modifications d’adresse IP, les modifications d’itinéraire IP ou les modifications de port Teredo sur un ordinateur local. Ces demandes sont effectuées en appelant NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2 ou NotifyTeredoPortChange. The
La fonction CancelMibChangeNotify2 annule également une demande précédente pour être avertie lorsque la table d’adresses IP de monodiffusion est stable sur un ordinateur local et peut être récupérée. Cette requête est effectuée en appelant la fonction NotifyStableUnicastIpAddressTable .

Le paramètre NotificationHandle retourné à ces fonctions de notification est passé à CancelMibChangeNotify2 pour désinscrire les notifications ou annuler une demande en attente de récupération de la table d’adresses IP de monodiffusion stable.

Une application ne peut pas effectuer un appel à la fonction CancelMibChangeNotify2 à partir du contexte du thread qui exécute actuellement la fonction de rappel de notification pour le même paramètre NotificationHandle . Sinon, le thread qui exécute ce rappel entraîne un blocage. Par conséquent, la fonction CancelMibChangeNotify2 ne doit pas être appelée directement dans le cadre de la routine de rappel de notification. Dans une situation plus générale, un thread qui exécute la fonction CancelMibChangeNotify2 ne peut pas posséder une ressource sur laquelle le thread qui exécute une opération de rappel de notification attendrait, car cela entraînerait un interblocage similaire. La fonction CancelMibChangeNotify2 doit être appelée à partir d’un thread différent, sur lequel le thread qui reçoit le rappel de notification n’a pas de dépendances.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	netioapi.h (include Iphlpapi.h)
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll