Функция CancelMibChangeNotify2 (netioapi.h)
Функция CancelMibChangeNotify2 отменяет регистрацию уведомлений об изменениях интерфейса IP, IP-адресов, ip-адресов, ip-маршрутов, изменений портов Teredo, а также о том, что таблица одноадресных IP-адресов стабильна и может быть получена.
Синтаксис
IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
[in] HANDLE NotificationHandle
);
Параметры
[in] NotificationHandle
Дескриптор, возвращенный функцией регистрации или извлечения уведомления, чтобы указать, какое уведомление следует отменить.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
В функцию передан недопустимый параметр. Эта ошибка возвращается, если параметр NotificationHandle был указателем NULL . |
|
Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки. |
Комментарии
Функция CancelMibChangeNotify2 определена в Windows Vista и более поздних версиях.
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 |