CreateIpForwardEntry2

ローカルコンピュータに新しい IP 経路エントリを作成する。

CreateIpForwardEntry2 Row

Row : [var] IP 経路エントリを表す MIB_IPFORWARD_ROW2 構造体へのポインタ。

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

解説

ローカルコンピュータに新しい IP 経路エントリを作成する。

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

[備考]
CreateIpForwardEntry2 関数は Windows Vista 以降で定義される。ローカルコンピュータに新しい IP
経路エントリを追加するのに使う。MIB_IPFORWARD_ROW2 構造体のメンバは InitializeIpForwardEntry
で既定値に初期化し、必要なメンバを変更してから CreateIpForwardEntry2 を呼ぶとよい。Row の
DestinationPrefix は有効な IPv4 / IPv6 アドレスプレフィックスで、NextHop
は有効なアドレスとファミリで初期化する必要がある。また InterfaceLuid または InterfaceIndex
のいずれかを初期化する必要がある。InterfaceLuid が優先され、ゼロなら InterfaceIndex が使われる。Metric
メンバの経路メトリックオフセットは完全なメトリックの一部に過ぎず、関連インターフェイスの MIB_IPINTERFACE_ROW の
Metric と合算される。インターフェイスメトリックは GetIpInterfaceEntry で取得できる。Age と Origin
メンバは無視され、ネットワークスタックが設定する。既存経路と DestinationPrefix / NextHop
が重複する場合は失敗する。本関数は Administrators
グループのメンバーとしてログオンしたユーザーからのみ呼び出せる。Administrators グループのメンバーでないユーザーが呼び出すと
ERROR_ACCESS_DENIED を返して失敗する。Windows Vista 以降のユーザーアカウント制御 (UAC)
によっても失敗しうる。この関数を含むアプリケーションをビルトイン Administrator 以外の Administrators
グループのメンバーが実行した場合、マニフェストファイルで requestedExecutionLevel を
requireAdministrator に設定していない限りこの呼び出しは失敗する。マニフェストがない場合は、昇格シェル
(管理者として実行) から起動する必要がある。

情報