SetIpForwardEntry2

ローカルコンピュータ上の IP 経路エントリのプロパティを設定する。

SetIpForwardEntry2 Route

Route : [var] IP 経路エントリの MIB_IPFORWARD_ROW2 構造体エントリへのポインタ。DestinationPrefix は有効な IP 宛先プレフィックスに、NextHop は有効な IP アドレスファミリとアドレスに設定し、InterfaceLuid または InterfaceIndex を指定する必要がある。

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

解説

ローカルコンピュータ上の IP 経路エントリのプロパティを設定する。

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

[備考]
SetIpForwardEntry2 関数は Windows Vista 以降で定義される。ローカルコンピュータ上の既存 IP
経路エントリのプロパティを設定する。Route が指す構造体の DestinationPrefix は有効な IP
アドレスプレフィックスとファミリで、NextHop は有効な IP アドレスとファミリで初期化する必要がある。さらに
InterfaceLuid または InterfaceIndex のいずれかを初期化し、前者が 0 なら後者が使われる。Metric
メンバの経路メトリックオフセットは完全な経路メトリックの一部に過ぎず、関連インターフェイスの MIB_IPINTERFACE_ROW の
Metric と合計したものが完全なメトリックとなる。インターフェイスメトリックは GetIpInterfaceEntry
で取得できる。Age と Origin メンバは SetIpForwardEntry2
呼び出し時には無視され、ネットワークスタックが設定する (変更不可)。DestinationPrefix と NextHop
が既存エントリと一致しなければ失敗する。Administrators グループメンバのみが呼び出せ、それ以外は
ERROR_ACCESS_DENIED。UAC のため、組み込み Administrator 以外は
requestedExecutionLevel=requireAdministrator または RunAs administrator
実行が必要。

情報