Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |