Функция CancelMibChangeNotify2
Функция CancelMibChangeNotify2 отменяет регистрацию уведомления об изменении драйвера об изменениях IP-интерфейса, IP-адресах, изменениях IP-маршрутов и запросах на получение стабильной одноадресной таблицы IP-адресов.
Синтаксис
NETIOAPI_API CancelMibChangeNotify2(
_In_ HANDLE NotificationHandle
);
Параметры
- NotificationHandle [in]
Дескриптор, возвращаемый функцией регистрации или извлечения уведомлений, чтобы указать, какое уведомление следует отменить.
Возвращаемое значение
CancelMibChangeNotify2 возвращает STATUS_SUCCESS, если функция выполнена успешно.
В случае сбоя функции CancelMibChangeNotify2 возвращает один из следующих кодов ошибок:
| Код возврата | Описание |
|---|---|
| STATUS_INVALID_PARAMETER | В функцию передан недопустимый параметр. CancelMibChangeNotify2 возвращает эту ошибку, если параметр NotificationHandle был указателем NULL . |
| Другое | Используйте функцию 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 |