Функция CancelMibChangeNotify2 (netioapi.h)

Статья
08/25/2023

Функция CancelMibChangeNotify2 отменяет регистрацию уведомлений об изменениях интерфейса IP, IP-адресов, ip-адресов, ip-маршрутов, изменений портов Teredo, а также о том, что таблица одноадресных IP-адресов стабильна и может быть получена.

Синтаксис

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

Параметры

[in] NotificationHandle

Дескриптор, возвращенный функцией регистрации или извлечения уведомления, чтобы указать, какое уведомление следует отменить.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.

Код возврата	Описание
ERROR_INVALID_PARAMETER	В функцию передан недопустимый параметр. Эта ошибка возвращается, если параметр NotificationHandle был указателем NULL .
Другое	Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

The
Функция CancelMibChangeNotify2 отменяет регистрацию уведомления об изменениях, запрошенных ранее для изменения ip-интерфейса, изменения IP-адресов, ip-маршрутов или изменений порта Teredo на локальном компьютере. Эти запросы выполняются путем вызова NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2 или NotifyTeredoPortChange. The
Функция CancelMibChangeNotify2 также отменяет предыдущий запрос на получение уведомлений, если таблица одноадресных IP-адресов стабильна на локальном компьютере и может быть получена. Этот запрос выполняется путем вызова функции NotifyStableUnicastIpAddressTable .

Параметр NotificationHandle , возвращаемый этим функциям уведомлений, передается в CancelMibChangeNotify2 для отмены регистрации уведомлений или отмены ожидающего запроса на получение стабильной таблицы одноадресных IP-адресов.

Приложение не может вызвать функцию CancelMibChangeNotify2 из контекста потока, который в настоящее время выполняет функцию обратного вызова уведомления для того же параметра NotificationHandle . В противном случае поток, выполняющий этот обратный вызов, приведет к взаимоблокировке. Поэтому функцию CancelMibChangeNotify2 нельзя вызывать напрямую в рамках процедуры обратного вызова уведомления. В более общей ситуации поток, выполняющий функцию CancelMibChangeNotify2 , не может владеть ресурсом, для которого поток, выполняющий операцию обратного вызова уведомления, будет ждать, так как это приведет к аналогичной взаимоблокировке. Функция CancelMibChangeNotify2 должна вызываться из другого потока, от которого поток, получающий обратный вызов уведомления, не имеет зависимостей.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	netioapi.h (включая Iphlpapi.h)
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll