struktur MIB_IPFORWARD_ROW2 (netioapi.h)
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 |
---|---|
|
Mekanisme perutean tidak ditentukan. |
|
Antarmuka lokal. |
|
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 . |
|
Hasil pengalihan ICMP. |
|
Exterior Gateway Protocol (EGP), protokol perutean dinamis. |
|
Protokol Gateway-ke-Gateway (GGP), protokol perutean dinamis. |
|
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. |
|
Berkeley Routing Information Protocol (RIP) atau RIP-II, protokol perutean dinamis. |
|
Protokol Intermediate System-to-Intermediate System (IS-IS), protokol perutean dinamis. Protokol IS-IS dikembangkan untuk digunakan dalam rangkaian protokol Open Systems Interconnection (OSI). |
|
Protokol End System-to-Intermediate System (ES-IS), protokol perutean dinamis. Protokol ES-IS dikembangkan untuk digunakan dalam rangkaian protokol Open Systems Interconnection (OSI). |
|
Cisco Interior Gateway Routing Protocol (IGRP), protokol perutean dinamis. |
|
Protokol Gateway Interior (IGP) Bolt, Beranek, dan Newman (BBN) yang menggunakan algoritma Shortest Path First (SPF). Ini adalah protokol perutean dinamis awal. |
|
Protokol Open Shortest Path First (OSPF), protokol perutean dinamis. |
|
Border Gateway Protocol (BGP), protokol perutean dinamis. |
|
Entri spesifik Windows yang awalnya ditambahkan oleh protokol perutean, tetapi sekarang statis. |
|
Entri spesifik Windows ditambahkan sebagai rute statis dari antarmuka pengguna perutean atau perintah perutean. |
|
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 .
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) |