Freigeben über


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

Weitere Informationen

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyUnicastIpAddressChange