struktur MIB_IPFORWARD_ROW2 (netioapi.h)

Artikel
08/25/2023

Struktur MIB_IPFORWARD_ROW2 menyimpan informasi tentang entri rute IP.

Sintaks

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

Jenis: NET_LUID

Pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan yang terkait dengan entri rute IP ini.

InterfaceIndex

Jenis: NET_IFINDEX

Nilai indeks lokal untuk antarmuka jaringan yang terkait dengan entri rute IP ini. Nilai indeks ini dapat berubah ketika adaptor jaringan dinonaktifkan dan kemudian diaktifkan, atau dalam keadaan lain, dan tidak boleh dianggap persisten.

DestinationPrefix

Jenis: IP_ADDRESS_PREFIX

Awalan alamat IP untuk alamat IP tujuan untuk rute ini.

NextHop

Jenis: SOCKADDR_INET

Untuk rute jarak jauh, alamat IP sistem atau gateway berikutnya dalam 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 IPv6 0:0 untuk entri rute IPv6.

SitePrefixLength

Jenis: UCHAR

Panjangnya, dalam bit, dari 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 umumnya digunakan untuk mewakili nilai ilegal.

ValidLifetime

Jenis: ULONG

Waktu maksimum, dalam detik, bahwa entri rute IP valid. Nilai 0xffffffff dianggap tak terbatas.

PreferredLifetime

Jenis: ULONG

Waktu yang disukai, dalam detik, bahwa entri rute IP valid. Nilai 0xffffffff dianggap tak terbatas.

Metric

Jenis: ULONG

Nilai offset metrik rute untuk entri rute IP ini. Perhatikan metrik rute aktual yang digunakan untuk menghitung preferensi rute adalah penjumlahan metrik antarmuka yang ditentukan dalam anggota Metrik struktur MIB_IPINTERFACE_ROW dan offset metrik rute yang ditentukan dalam anggota ini. Semantik metrik ini ditentukan oleh protokol perutean yang ditentukan dalam anggota Protokol . Jika metrik ini tidak digunakan, nilainya harus diatur ke -1. Nilai ini di dokumentasikan dalam RFC 4292. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc4292.txt.

Protocol

Jenis: NL_ROUTE_PROTOCOL

Mekanisme perutean bagaimana rute IP ini ditambahkan. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NL_ROUTE_PROTOCOL yang ditentukan dalam file header Nldef.h . Anggota dijelaskan dalam RFC 4292. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc4292.txt.

Perhatikan bahwa header Nldef.h secara otomatis disertakan oleh file header Ipmib.h yang secara otomatis disertakan oleh header Iprtrmib.h . Header Iphlpapi.h secara otomatis menyertakan file header Iprtrmib.h . File header Iprtrmib.h, Ipmib.h, dan Nldef.h tidak boleh digunakan secara langsung.

Daftar berikut ini memperlihatkan nilai yang mungkin untuk anggota ini.

Nilai	Makna
MIB_IPPROTO_OTHER 1	Mekanisme perutean tidak ditentukan.
MIB_IPPROTO_LOCAL 2	Antarmuka lokal.
MIB_IPPROTO_NETMGMT 3	Rute statis. Nilai ini digunakan untuk mengidentifikasi informasi rute untuk perutean IP yang ditetapkan melalui manajemen jaringan seperti Dynamic Host Configuration Protocol (DCHP), Simple Network Management Protocol (SNMP), atau dengan panggilan ke fungsi CreateIpForwardEntry2, DeleteIpForwardEntry2, atau SetIpForwardEntry2 .
MIB_IPPROTO_ICMP 4	Hasil pengalihan ICMP.
MIB_IPPROTO_EGP 5	Exterior Gateway Protocol (EGP), protokol perutean dinamis.
MIB_IPPROTO_GGP 6	Protokol Gateway-ke-Gateway (GGP), protokol perutean dinamis.
MIB_IPPROTO_HELLO 7	Protokol Hellospeak, protokol perutean dinamis. Ini adalah entri historis yang tidak lagi digunakan dan merupakan protokol perutean awal yang digunakan oleh router ARPANET asli yang menjalankan perangkat lunak khusus yang disebut protokol perutean Fuzzball, kadang-kadang disebut Hellospeak, seperti yang dijelaskan dalam RFC 891 dan RFC 1305. Untuk informasi lebih lanjut, lihat http://www.ietf.org/rfc/rfc891.txt dan http://www.ietf.org/rfc/rfc1305.txt.
MIB_IPPROTO_RIP 8	Berkeley Routing Information Protocol (RIP) atau RIP-II, protokol perutean dinamis.
MIB_IPPROTO_IS_IS 9	Protokol Intermediate System-to-Intermediate System (IS-IS), protokol perutean dinamis. Protokol IS-IS dikembangkan untuk digunakan dalam rangkaian protokol Open Systems Interconnection (OSI).
MIB_IPPROTO_ES_IS 10	Protokol End System-to-Intermediate System (ES-IS), protokol perutean dinamis. Protokol ES-IS dikembangkan untuk digunakan dalam rangkaian protokol Open Systems Interconnection (OSI).
MIB_IPPROTO_CISCO 11	Cisco Interior Gateway Routing Protocol (IGRP), protokol perutean dinamis.
MIB_IPPROTO_BBN 12	Protokol Gateway Interior (IGP) Bolt, Beranek, dan Newman (BBN) yang menggunakan algoritma Shortest Path First (SPF). Ini adalah protokol perutean dinamis awal.
MIB_IPPROTO_OSPF 13	Protokol Open Shortest Path First (OSPF), protokol perutean dinamis.
MIB_IPPROTO_BGP 14	Border Gateway Protocol (BGP), protokol perutean dinamis.
MIB_IPPROTO_NT_AUTOSTATIC 10002	Entri spesifik Windows yang awalnya ditambahkan oleh protokol perutean, tetapi sekarang statis.
MIB_IPPROTO_NT_STATIC 10006	Entri spesifik Windows ditambahkan sebagai rute statis dari antarmuka pengguna perutean atau perintah perutean.
MIB_IPPROTO_NT_STATIC_NON_DOD 10007	Entri khusus Windows ditambahkan sebagai rute statis dari antarmuka pengguna perutean atau perintah perutean, kecuali rute ini tidak menyebabkan Dial On Demand (DOD).

Loopback

Jenis: BOOLEAN

Nilai yang menentukan apakah rute adalah rute loopback (gateway ada di host lokal).

AutoconfigureAddress

Jenis: BOOLEAN

Nilai yang menentukan apakah alamat IP dikonfigurasi secara otomatis.

Publish

Jenis: BOOLEAN

Nilai yang menentukan apakah rute diterbitkan.

Immortal

Jenis: BOOLEAN

Nilai yang menentukan apakah rute abadi.

Age

Jenis: ULONG

Jumlah detik sejak rute ditambahkan atau dimodifikasi dalam tabel perutean jaringan.

Origin

Jenis: NL_ROUTE_ORIGIN

Asal rute. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NL_ROUTE_ORIGIN yang ditentukan dalam file header Nldef.h .

Nilai	Makna
NlroManual 0	Hasil konfigurasi manual.
NlroWellKnown 1	Rute terkenal.
NlroDHCP 2	Hasil konfigurasi DHCP.
NlrorouterAdvertisement 3	Hasil dari iklan router.
Nlro6to4 4	Hasil penerowongan 6to4.

Keterangan

Struktur MIB_IPFORWARD_ROW2 didefinisikan pada Windows Vista dan yang lebih baru.

Fungsi GetIpForwardTable2 menghitung entri rute IP pada sistem lokal dan mengembalikan informasi ini dalam struktur MIB_IPFORWARD_TABLE2 sebagai array entri MIB_IPFORWARD_ROW2 .

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

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

Anggota Metrik dari 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 dihargai dalam hal kecepatan tautan, jumlah hop, atau penundaan waktu. Metrik otomatis adalah fitur pada Windows XP dan yang lebih baru yang secara otomatis mengonfigurasi metrik untuk rute lokal yang didasarkan pada kecepatan tautan. Fitur metrik otomatis diaktifkan secara default (anggota UseAutomaticMetric dari struktur MIB_IPINTERFACE_ROW diatur ke TRUE) pada Windows XP dan yang lebih baru. Ini juga dapat dikonfigurasi secara manual untuk menetapkan metrik tertentu ke rute IP.

Metrik rute yang ditentukan dalam anggota Metrik 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 anggota Metrik dari struktur MIB_IPINTERFACE_ROW antarmuka terkait. Aplikasi dapat mengambil metrik antarmuka dengan memanggil fungsi GetIpInterfaceEntry .

Perhatikan bahwa file header Netioapi.h secara otomatis disertakan dalam file header Iphlpapi.h . File header Netioapi.h tidak boleh digunakan secara langsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	netioapi.h (termasuk Iphlpapi.h)