CancelMibChangeNotify2-Funktion (netioapi.h)

Die CancelMibChangeNotify2-Funktion hebt die Registrierung für Änderungsbenachrichtigungen für IP-Schnittstellenänderungen, IP-Adressänderungen, IP-Routenänderungen, Teredo-Portänderungen und ab, wenn die Unicast-IP-Adresstabelle stabil ist und abgerufen werden kann.

Syntax

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

Parameter

[in] NotificationHandle

Das handle, das von einer Benachrichtigungsregistrierungs- oder Abruffunktion zurückgegeben wird, um anzugeben, welche Benachrichtigung abgebrochen werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn der NotificationHandle-Parameter ein NULL-Zeiger war.
Andere	Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die CancelMibChangeNotify2-Funktion ist unter Windows Vista und höher definiert.

The
Die CancelMibChangeNotify2-Funktion hebt die Registrierung für eine Änderungsbenachrichtigung auf, die zuvor für IP-Schnittstellenänderungen, IP-Adressänderungen, IP-Routenänderungen oder Teredo-Portänderungen auf einem lokalen Computer angefordert wurde. Diese Anforderungen werden durch aufrufen NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2 oder NotifyTeredoPortChange. The
Die CancelMibChangeNotify2-Funktion bricht auch eine vorherige Anforderung ab, um benachrichtigt zu werden, wenn die Unicast-IP-Adresstabelle auf einem lokalen Computer stabil ist und abgerufen werden kann. Diese Anforderung erfolgt durch Aufrufen der NotifyStableUnicastIpAddressTable-Funktion .

Der NotificationHandle-Parameter , der an diese Benachrichtigungsfunktionen zurückgegeben wird, wird an CancelMibChangeNotify2 übergeben, um die Registrierung für Benachrichtigungen aufzuheben oder eine ausstehende Anforderung zum Abrufen der stabilen Unicast-IP-Adresstabelle abzubrechen.

Eine Anwendung kann keinen Aufruf der CancelMibChangeNotify2-Funktion aus dem Kontext des Threads ausführen, der derzeit die Benachrichtigungsrückruffunktion für denselben NotificationHandle-Parameter ausführt. Andernfalls führt der Thread, der diesen Rückruf ausführt, zu einem Deadlock. Daher darf die CancelMibChangeNotify2-Funktion nicht direkt im Rahmen der Benachrichtigungsrückrufroutine aufgerufen werden. In einer allgemeineren Situation kann ein Thread, der die CancelMibChangeNotify2-Funktion ausführt, keine Ressource besitzen, für die der Thread, der einen Benachrichtigungsrückrufvorgang ausführt, warten würde, da dies zu einem ähnlichen Deadlock führen würde. Die CancelMibChangeNotify2-Funktion sollte von einem anderen Thread aufgerufen werden, von dem der Thread, der den Benachrichtigungsrückruf empfängt, keine Abhängigkeiten aufweist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll

Weitere Informationen

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange

NotifyUnicastIpAddressChange