Функция 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 (include Netioapi.h) |
Библиотека |
Netio.lib |
IRQL |
PASSIVE_LEVEL |