Поделиться через


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

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

Синтаксис

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API NotifyNetworkConnectivityHintChange(
  [in]  PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK Callback,
  [in]  PVOID                                      CallerContext,
  [in]  BOOLEAN                                    InitialNotification,
  [out] PHANDLE                                    NotificationHandle
);

Параметры

[in] Callback

Указатель функции типа PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK, который указывает на определяемую приложением функцию обратного вызова. Функция обратного вызова будет вызываться при изменении уровня сетевого подключения или изменения затрат.

[in] CallerContext

Контекст вызывающего абонента для конкретного пользователя. Этот контекст будет передан функции обратного вызова.

[in] InitialNotification

True Значение , если должно быть предоставлено уведомление об инициализации; в противном случае — falseзначение .

[out] NotificationHandle

Указатель на HANDLE. Функция задает значение дескриптора регистрации уведомления.

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

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

Комментарии

Чтобы отменить регистрацию уведомлений об изменениях, вызовите функцию CancelMibChangeNotify2 , передав параметр NotificationHandle , возвращенный NotifyNetworkConnectivityHintChange.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 2004 (10.0; Сборка 19041)
Минимальная версия сервера Windows Server версии 2004 (10.0; Сборка 19041)
Целевая платформа Windows
Header netioapi.h (включая Iphlpapi.h)
Библиотека Iphlpapi.lib
DLL Iphlpapi.dll

См. также раздел