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

こちらもご覧ください

• PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK

• CancelMibChangeNotify2