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 |