CancelMibChangeNotify2 函数
CancelMibChangeNotify2 函数取消注册针对 IP 接口更改、IP 地址更改、IP 路由更改和检索稳定单播 IP 地址表的请求的驱动程序更改通知。
语法
NETIOAPI_API CancelMibChangeNotify2(
_In_ HANDLE NotificationHandle
);
参数
- NotificationHandle [in]
从通知注册或检索函数返回的句柄,用于指示要取消的通知。
返回值
如果函数成功,CancelMibChangeNotify2 将返回STATUS_SUCCESS。
如果该函数失败, CancelMibChangeNotify2 将返回以下错误代码之一:
返回代码 | 说明 |
---|---|
STATUS_INVALID_PARAMETER | 向该函数传递了无效参数。 如果 NotificationHandle 参数为 NULL 指针,CancelMibChangeNotify2 将返回此错误。 |
其他 | 使用 FormatMessage 函数获取返回错误的消息字符串。 |
注解
CancelMibChangeNotify2 函数取消注册以前针对本地计算机上的 IP 接口更改、IP 地址更改或 IP 路由更改请求的驱动程序更改通知。 这些请求通过调用 NotifyIpInterfaceChange、 NotifyRouteChange2 或 NotifyUnicastIpAddressChange 发出。 CancelMibChangeNotify2 函数还会取消以前在本地计算机上检索稳定单播 IP 地址表的请求。 此请求是通过调用 NotifyStableUnicastIpAddressTable 函数发出的。
返回到这些通知函数的 NotificationHandle 参数将传递给 CancelMibChangeNotify2 ,以取消注册驱动程序更改通知或取消挂起的请求以检索稳定的单播 IP 地址表。
要求
目标平台 |
通用 |
版本 |
在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
标头 |
Netioapi.h (包括 Netioapi.h) |
库 |
Netio.lib |
IRQL |
PASSIVE_LEVEL |