struktur MIB_IPFORWARD_ROW2

Artikel
03/13/2025

Struktur MIB_IPFORWARD_ROW2 menyimpan informasi tentang entri rute IP.

Sintaksis

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;

Anggota

InterfaceLuid
Pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan yang terkait dengan entri rute IP ini.
InterfaceIndex
Nilai indeks lokal untuk antarmuka jaringan yang terkait dengan entri rute IP ini. Nilai indeks ini mungkin berubah ketika adaptor jaringan dinonaktifkan dan kemudian diaktifkan, atau dalam keadaan lain, dan tidak boleh dianggap persisten.
DestinationPrefix
Awalan alamat IP untuk alamat IP tujuan untuk rute ini.
NextHop
Untuk rute jarak jauh, alamat IP sistem atau gateway berikutnya yang berada di sepanjang rute. Jika rutenya adalah ke alamat loopback lokal atau alamat IP pada tautan lokal, hop berikutnya tidak ditentukan (semua nol). Untuk rute loopback lokal, anggota ini harus menjadi alamat IPv4 0.0.0.0 untuk entri rute IPv4 atau alamat alamat IPv6 0:0 untuk entri rute IPv6.
SitePrefixLength
Panjangnya, dalam bit, awalan situs atau bagian jaringan dari alamat IP untuk rute ini. Untuk entri rute IPv4, nilai apa pun yang lebih besar dari 32 adalah nilai ilegal. Untuk entri rute IPv6, nilai apa pun yang lebih besar dari 128 adalah nilai ilegal. Nilai 255 biasanya digunakan untuk mewakili nilai ilegal.
ValidLifetime
Waktu maksimum, dalam detik, bahwa entri rute IP valid. Nilai 0xffffffff dianggap tidak terbatas.
PreferredLifetime
Waktu yang disukai, dalam detik, bahwa entri rute IP valid. Nilai 0xffffffff dianggap tidak terbatas.
Metrik
Nilai offset metrik rute untuk entri rute IP ini. Perhatikan metrik rute aktual yang digunakan untuk menghitung preferensi rute adalah metrik antarmuka yang ditentukan dalam metrik anggota struktur MIB_IPINTERFACE_ROW yang ditambahkan ke offset metrik rute yang ditentukan dalam anggota Metrik ini. Semantik metrik ini ditentukan oleh protokol perutean yang ditentukan dalam Protokol anggota. Jika metrik ini tidak digunakan, nilainya harus diatur ke -1. Nilai ini didokumenkan dalam RFC 4292. Untuk informasi selengkapnya, lihat Tabel Penerusan IP MIB.
Protokol
Jenis mekanisme perutean NL_ROUTE_PROTOCOL yang ditambahkan oleh rute IP ini.
loopback
Nilai yang menentukan apakah rute adalah rute loopback (gateway ada di host lokal).
AutoconfigureAddress
Nilai yang menentukan apakah alamat IP dikonfigurasi otomatis.
Terbitkan
Nilai yang menentukan apakah rute diterbitkan.
Abadi
Nilai yang menentukan apakah rute abadi.
Usia
Jumlah detik sejak rute ditambahkan atau dimodifikasi dalam tabel perutean jaringan.
Asal
Jenis asal rute IP NL_ROUTE_ORIGIN.

Komentar

FungsiGetIpForwardTable2 menghitung entri rute IP di komputer lokal dan mengembalikan informasi ini dalam struktur MIB_IPFORWARD_TABLE2 sebagai array entri MIB_IPFORWARD_ROW2.

Fungsi GetIpForwardEntry2 mengambil satu entri rute IP dan mengembalikan informasi ini dalam struktur MIB_IPFORWARD_ROW2.

Entri dengan Awalan dan PrefiksLength anggota IP_ADDRESS_PREFIX diatur ke nol di DestinationPrefix anggota dalam struktur MIB_IPFORWARD_ROW2 dianggap sebagai rute default. MIB_IPFORWARD_TABLE2 mungkin berisi beberapa entri MIB_IPFORWARD_ROW2 dengan Awalan dan PrefiksLength anggota IP_ADDRESS_PREFIX diatur ke nol di anggota DestinationPrefix ketika ada beberapa adaptor jaringan yang diinstal.

Metrik anggota entri MIB_IPFORWARD_ROW2 adalah nilai yang ditetapkan ke rute IP untuk antarmuka jaringan tertentu yang mengidentifikasi biaya yang terkait dengan penggunaan rute tersebut. Misalnya, metrik dapat dinilai dalam hal kecepatan tautan, jumlah hop, atau penundaan waktu. Metrik otomatis adalah fitur pada Windows XP dan versi yang lebih baru dari sistem operasi Windows yang secara otomatis mengonfigurasi metrik untuk rute lokal yang didasarkan pada kecepatan tautan. Secara default, fitur metrik otomatis diaktifkan (UseAutomaticMetric anggota struktur MIB_IPINTERFACE_ROW diatur ke TRUE) di Windows XP dan yang lebih baru. Anda juga dapat mengonfigurasi fitur ini secara manual untuk menetapkan metrik tertentu ke rute IP.

Metrik rute yang ditentukan dalam Metrik anggota struktur MIB_IPFORWARD_ROW2 hanya mewakili offset metrik rute. Metrik lengkap adalah kombinasi dari offset metrik rute ini yang ditambahkan ke metrik antarmuka yang ditentukan dalam metrik anggota struktur MIB_IPINTERFACE_ROW antarmuka terkait. Driver dapat mengambil metrik antarmuka dengan memanggil fungsiGetIpInterfaceEntry.