CancelMibChangeNotify2, fonction (netioapi.h)
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 |
|---|---|
|
Un paramètre non valide a été transmis à la fonction. Cette erreur est retournée si le paramètre NotificationHandle était un pointeur NULL . |
|
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 |