CancelMibChangeNotify2-Funktion
Die CancelMibChangeNotify2-Funktion hebt die Registrierung einer Treiberänderungsbenachrichtigung für IP-Schnittstellenänderungen, IP-Adressänderungen, IP-Routenänderungen und Anforderungen zum Abrufen der stabilen Unicast-IP-Adresstabelle auf.
Syntax
NETIOAPI_API CancelMibChangeNotify2(
_In_ HANDLE NotificationHandle
);
Parameter
- NotificationHandle [in]
Das Handle, das von einer Benachrichtigungsregistrierungs- oder Abruffunktion zurückgegeben wird, um anzugeben, welche Benachrichtigung abgebrochen werden soll.
Rückgabewert
CancelMibChangeNotify2 gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.
Wenn die Funktion fehlschlägt, gibt CancelMibChangeNotify2 einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Es wurde ein ungültiger Parameter an die Funktion übergeben. CancelMibChangeNotify2 gibt diesen Fehler zurück, wenn der NotificationHandle-Parameter ein NULL-Zeiger war. |
| Andere | Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Bemerkungen
Die CancelMibChangeNotify2-Funktion hebt die Registrierung einer Treiberänderungsbenachrichtigung auf, die zuvor für IP-Schnittstellenänderungen, IP-Adressänderungen oder IP-Routenänderungen auf einem lokalen Computer angefordert wurde. Diese Anforderungen werden durch aufrufen NotifyIpInterfaceChange, NotifyRouteChange2 oder NotifyUnicastIpAddressChange. Die CancelMibChangeNotify2-Funktion bricht auch eine vorherige Anforderung zum Abrufen der stabilen Unicast-IP-Adresstabelle auf einem lokalen Computer ab. 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 von Treiberänderungsbenachrichtigungen aufzuheben oder eine ausstehende Anforderung zum Abrufen der stabilen Unicast-IP-Adresstabelle abzubrechen.
Anforderungen
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |