通过

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 函数，传递 NotifyNetworkConnectivityHintChange 返回的 NotificationHandle 参数。

要求

要求 值
最低受支持的客户端 Windows 10，版本 2004 (10.0;内部版本 19041)
最低受支持的服务器 Windows Server 版本 2004 (10.0;内部版本 19041)
目标平台 Windows
标头 netioapi.h (包括 Iphlpapi.h)
Library Iphlpapi.lib
DLL Iphlpapi.dll

另请参阅