NotifyIpInterfaceChange

ローカルコンピュータ上のすべての IP インターフェイス、IPv4 インターフェイス、IPv6 インターフェイスの変更通知を登録する。

NotifyIpInterfaceChange Family, Callback, CallerContext, InitialNotification, NotificationHandle

Family : [int] 変更通知を登録するアドレスファミリ。アドレスファミリの値は Winsock2.h で定義される。AF_ と PF_ の定数は等価 (例: AF_INET と PF_INET) である。Windows Vista 以降向け SDK では Ws2def.h で定義される。Ws2def.h は Winsock2.h から自動インクルードされるので直接使用してはならない。現在サポートされる値は AF_INET、AF_INET6、AF_UNSPEC である。
Callback : [int] 変更発生時に呼び出す関数へのポインタ。インターフェイス通知受信時に起動される。
CallerContext : [intptr] インターフェイス通知受信時に Callback に渡されるユーザコンテキスト。
InitialNotification : [int] 変更通知の登録完了直後にコールバックを起動するかどうかを示す値。この初回通知は IP インターフェイスの変更を示すものではなく、コールバックの登録確認のためのものである。
NotificationHandle : [intptr] 変更通知の解除に後で使用できるハンドルを返すためのポインタ。成功時はハンドルが返され、エラー時は NULL が返される。

(プラグイン / モジュール : iphlpapi.dll)

解説

ローカルコンピュータ上のすべての IP インターフェイス、IPv4 インターフェイス、IPv6 インターフェイスの変更通知を登録する。

[戻り値]
関数が成功すると、戻り値は NO_ERROR である。失敗した場合は以下のエラーコードのいずれかが返される。
このドキュメントは省略されている。

[備考]
NotifyIpInterfaceChange 関数は Windows Vista 以降で定義される。Family は
AF_INET、AF_INET6、AF_UNSPEC のいずれかでなければならない。Callback
の呼び出しはシリアライズされる。コールバック関数は VOID 型で定義する。コールバックに渡されるパラメータは次のとおり:
このドキュメントは省略されている。

情報