CancelMibChangeNotify2 函数 (netioapi.h)

CancelMibChangeNotify2 函数取消注册 IP 接口更改、IP 地址更改、IP 路由更改、Teredo 端口更改以及单播 IP 地址表稳定且可检索的更改通知。

语法

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

参数

[in] NotificationHandle

从通知注册或检索函数返回的句柄，用于指示要取消的通知。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

返回代码	说明
ERROR_INVALID_PARAMETER	向该函数传递了无效参数。 如果 NotificationHandle 参数是 NULL 指针，则返回此错误。
其他	使用 FormatMessage 获取返回错误的消息字符串。

注解

CancelMibChangeNotify2 函数在 Windows Vista 及更高版本上定义。

The
取消取消注册之前针对本地计算机上的 IP 接口更改、IP 地址更改、IP 路由更改或 Teredo 端口更改请求的更改通知的 CancelMibChangeNotify2 函数。 这些请求通过调用 NotifyIpInterfaceChange、 NotifyUnicastIpAddressChange、 NotifyRouteChange2 或 NotifyTeredoPortChange 发出。 The
CancelMibChangeNotify2 函数还会取消当单播 IP 地址表在本地计算机上稳定且可检索时收到通知的先前请求。 此请求是通过调用 NotifyStableUnicastIpAddressTable 函数发出的。

返回到这些通知函数的 NotificationHandle 参数将传递给 CancelMibChangeNotify2 ，以取消通知的注册，或取消挂起的请求以检索稳定的单播 IP 地址表。

应用程序无法从当前正在为同一 NotificationHandle 参数执行通知回调函数的线程的上下文调用 CancelMibChangeNotify2 函数。 否则，执行该回调的线程将导致死锁。 因此，不能在通知回调例程中直接调用 CancelMibChangeNotify2 函数。 在更一般的情况下，执行 CancelMibChangeNotify2 函数的线程不能拥有执行通知回调操作的线程将等待的资源，因为这将导致类似的死锁。 应从其他线程调用 CancelMibChangeNotify2 函数，接收通知回调的线程不依赖于该线程。

要求

要求	值
最低受支持的客户端	Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 | UWP 应用]
目标平台	Windows
标头	netioapi.h (包括 Iphlpapi.h)
Library	Iphlpapi.lib
DLL	Iphlpapi.dll

另请参阅

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange

NotifyUnicastIpAddressChange