FlushIpNetTable2

FlushIpNetTable2 関数は、ローカルコンピュータの IP 近隣テーブルをフラッシュする。

FlushIpNetTable2 Family, InterfaceIndex

Family : [int] フラッシュするアドレスファミリ。指定可能な値は Winsock2.h ヘッダファイルに列挙されている。AF_ アドレスファミリ定数と PF_ プロトコルファミリ定数は同じ値 (例: AF_INET と PF_INET) なのでどちらを使ってもよい。Windows Vista 以降向けの Windows SDK ではヘッダファイルの構成が変更され、この値は Ws2def.h ヘッダで定義される。Ws2def.h は Winsock2.h から自動的にインクルードされるため直接使用してはならない。現在サポートされる値は AF_INET、AF_INET6、AF_UNSPEC である。
InterfaceIndex : [int] インターフェイスインデックス。指定すると特定のインターフェイス上の近隣 IP アドレスエントリをフラッシュし、そうでなければ全インターフェイスをフラッシュする。無視するには 0 を指定する。

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

解説

FlushIpNetTable2 関数は、ローカルコンピュータの IP 近隣テーブルをフラッシュする。

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

[備考]
FlushIpNetTable2 関数は Windows Vista 以降で定義される。ローカルシステム上の近隣 IP
アドレスをフラッシュ (削除) する。Family で削除対象ファミリを限定できる。IPv4 / IPv6 両方を削除するなら
AF_UNSPEC を指定する。InterfaceIndex でインターフェイスを限定でき、全インターフェイス対象なら 0
を指定する。Family は AF_INET / AF_INET6 / AF_UNSPEC のいずれか。本関数は
Administrators グループのメンバーとしてログオンしたユーザーからのみ呼び出せる。Administrators
グループのメンバーでないユーザーが呼び出すと ERROR_ACCESS_DENIED を返して失敗する。Windows Vista
以降のユーザーアカウント制御 (UAC) によっても失敗しうる。この関数を含むアプリケーションをビルトイン Administrator
以外の Administrators グループのメンバーが実行した場合、マニフェストファイルで
requestedExecutionLevel を requireAdministrator
に設定していない限りこの呼び出しは失敗する。マニフェストがない場合は、昇格シェル (管理者として実行) から起動する必要がある。

情報