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 |
|---|---|
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn der NotificationHandle-Parameter ein NULL-Zeiger war. |
|
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 |