DeleteIpForwardEntry

ローカルコンピュータの IPv4 ルーティングテーブルから既存経路を削除する。

DeleteIpForwardEntry pRoute

pRoute : [var] 削除対象の経路を識別する MIB_IPFORWARDROW 構造体へのポインタ。dwForwardIfIndex、dwForwardDest、dwForwardMask、dwForwardNextHop、dwForwardProto のメンバを設定する必要がある。

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

解説

ローカルコンピュータの IPv4 ルーティングテーブルから既存経路を削除する。

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

[備考]
dwForwardProto は MIB_IPPROTO_NETMGMT に設定する必要がある。そうでないと失敗する。Windows
Vista / Server 2008 では単一サブインターフェイスのインターフェイスでしか動作しない。dwForwardPolicy
などいくつかのメンバは現在使用されない。既存経路の変更には SetIpForwardEntry、IPv4 ルーティングテーブル取得には
GetIpForwardTable を使う。Windows Vista 以降では 本関数は Administrators
グループのメンバーとしてログオンしたユーザーからのみ呼び出せる。Administrators グループのメンバーでないユーザーが呼び出すと
ERROR_ACCESS_DENIED を返して失敗する。Windows Vista 以降のユーザーアカウント制御 (UAC)
によっても失敗しうる。この関数を含むアプリケーションをビルトイン Administrator 以外の Administrators
グループのメンバーが実行した場合、マニフェストファイルで requestedExecutionLevel を
requireAdministrator に設定していない限りこの呼び出しは失敗する。マニフェストがない場合は、昇格シェル
(管理者として実行) から起動する必要がある。
注: Windows NT 4.0 および Windows 2000 以降ではこの関数は特権操作を行う。成功させるには、呼び出し元が
Administrators グループまたは NetworkConfigurationOperators
グループのメンバーである必要がある。

情報