MIB_IPFORWARD_ROW2 構造体

[アーティクル]
04/08/2024

MIB_IPFORWARD_ROW2 構造体には、IP ルートエントリに関する情報が格納されます。

構文

typedef struct _MIB_IPFORWARD_ROW2 {
  NET_LUID          InterfaceLuid;
  NET_IFINDEX       InterfaceIndex;
  IP_ADDRESS_PREFIX DestinationPrefix;
  SOCKADDR_INET     NextHop;
  UCHAR             SitePrefixLength;
  ULONG             ValidLifetime;
  ULONG             PreferredLifetime;
  ULONG             Metric;
  NL_ROUTE_PROTOCOL Protocol;
  BOOLEAN           Loopback;
  BOOLEAN           AutoconfigureAddress;
  BOOLEAN           Publish;
  BOOLEAN           Immortal;
  ULONG             Age;
  NL_ROUTE_ORIGIN   Origin;
} MIB_IPFORWARD_ROW2, *PMIB_IPFORWARD_ROW2;

メンバー

InterfaceLuid
この IP ルートエントリに関連付けられているネットワークインターフェイスのローカル一意識別子 (LUID)。
InterfaceIndex
この IP ルートエントリに関連付けられているネットワークインターフェイスのローカルインデックス値。このインデックス値は、ネットワークアダプターを無効にしてから有効にした場合、またはその逆を行った場合に変更される可能性があり、永続的と見なすべきではありません。
DestinationPrefix
このルートの宛先 IP アドレスの IP アドレスプレフィックス。
NextHop
リモートルートの場合、ルートに沿った次のシステムまたはゲートウェイの IP アドレス。ローカルループバックアドレスまたはローカルリンク上の IP アドレスへのルートの場合、ネクストホップは指定されません (すべてゼロ)。ローカルループバックルートの場合、このメンバーは IPv4 ルートエントリに対しては 0.0.0.0 という IPv4 アドレスに、IPv6 ルートエントリに対しては 0::0 という IPv6 アドレスにする必要があります。
SitePrefixLength
このルートの IP アドレスのサイトプレフィックスまたはネットワーク部分の長さ (ビット単位)。 IPv4 ルートエントリの場合、32 より大きい値は無効な値です。 IPv6 ルートエントリの場合、128 より大きい値は無効な値です。通常、255 という値は無効な値を表すために使用されます。
ValidLifetime
IP ルートエントリが有効な最大時間 (秒単位)。 0xffffffff という値は無限であると見なされます。
PreferredLifetime
IP ルートエントリが有効な優先時間 (秒単位)。 0xffffffff という値は無限であると見なされます。
メトリック
この IP ルートエントリのルートメトリックオフセット値。ルート設定の計算に使用される実際のルートメトリックは、この Metric メンバーで指定されるルートメトリックオフセットに追加された MIB_IPINTERFACE_ROW 構造体の Metric メンバーで指定されているインターフェイスメトリックであることにご注意ください。このメトリックのセマンティクスは、Protocol メンバーで指定されているルーティングプロトコルによって決まります。このメトリックを使用しない場合は、その値を -1 に設定する必要があります。この値は RFC 4292 に記載されています。詳細については、「IP 転送テーブル MIB」を参照してください。
プロトコル
この IP ルートが追加された NL_ROUTE_PROTOCOL ルーティングメカニズムの種類。
Loopback
ルートがループバックルート (ゲートウェイがローカルホスト上にある) かどうかを指定する値。
AutoconfigureAddress
IP アドレスが自動構成されているかどうかを示す値。
発行
ルートが発行されるかどうかを指定する値。
Immortal
ルートが不変かどうかを指定する値。
年齢
ネットワークルーティングテーブルでルートが追加または変更されてからの秒数。
元のドメイン
NL_ROUTE_ORIGIN IP ルートの配信元の種類。

解説

GetIpForwardTable2 関数は、ローカルコンピューター上の IP ルートエントリを列挙し、MIB_IPFORWARD_ROW2 エントリの配列として MIB_IPFORWARD_TABLE2 構造体でこの情報を返します。

GetIpForwardEntry2 関数は、単一の IP ルートエントリを取得し、この情報をMIB_IPFORWARD_ROW2 構造体で返します。

MIB_IPFORWARD_ROW2 構造体の DestinationPrefix メンバーで、IP_ADDRESS_PREFIX の Prefix メンバーと PrefixLength メンバーが 0 に設定されているエントリは、既定のルートと見なされます。 MIB_IPFORWARD_TABLE2 には、複数のネットワークアダプターがインストールされている場合に DestinationPrefix で IP_ADDRESS_PREFIX の Prefix メンバーと PrefixLength メンバーが 0 に設定されている複数の MIB_IPFORWARD_ROW2 エントリが含まれる場合があります。

IB_IPFORWARD_ROW2 エントリの Metric メンバーは、特定のネットワークインターフェイスの IP ルートに割り当てられる値であり、そのルートの使用に関連するコストを確認できます。たとえば、このメトリックは、リンク速度、ホップ数、または遅延時間の観点から評価できます。自動メトリックは、リンク速度に基づいてローカルルートのメトリックを自動的に構成する Windows XP 以降のバージョンの Windows オペレーティングシステムの機能です。既定では、Windows XP 以降では、自動メトリック機能が有効になっています (MIB_IPINTERFACE_ROW 構造体の UseAutomaticMetric メンバーが TRUE に設定されています)。この機能を手動で構成して、特定のメトリックを IP ルートに割り当てることもできます。

MIB_IPFORWARD_ROW2 構造体の Metric メンバーで指定されているルートメトリックは、ルートメトリックオフセットのみを表します。完全なメトリックは、関連付けられているインターフェイスの MIB_IPINTERFACE_ROW 構造体の Metric メンバーで指定されているインターフェイスメトリックに、このルートメトリックオフセットを追加してできる組み合わせです。ドライバーは、GetIpInterfaceEntry 関数を呼び出すと、インターフェイスメトリックを取得できます。

要件

バージョン	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
ヘッダー	Netioapi.h (Netioapi.h を含む)

次の方法で共有

MIB_IPFORWARD_ROW2 構造体

構文

メンバー

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース