struktur MIB_IPFORWARDROW (ipmib.h)

Artikel
08/24/2023

Struktur MIB_IPFORWARDROW berisi informasi yang menjelaskan rute jaringan IPv4.

Sintaks

typedef struct _MIB_IPFORWARDROW {
  DWORD    dwForwardDest;
  DWORD    dwForwardMask;
  DWORD    dwForwardPolicy;
  DWORD    dwForwardNextHop;
  IF_INDEX dwForwardIfIndex;
  union {
    DWORD              dwForwardType;
    MIB_IPFORWARD_TYPE ForwardType;
  };
  union {
    DWORD               dwForwardProto;
    MIB_IPFORWARD_PROTO ForwardProto;
  };
  DWORD    dwForwardAge;
  DWORD    dwForwardNextHopAS;
  DWORD    dwForwardMetric1;
  DWORD    dwForwardMetric2;
  DWORD    dwForwardMetric3;
  DWORD    dwForwardMetric4;
  DWORD    dwForwardMetric5;
} MIB_IPFORWARDROW, *PMIB_IPFORWARDROW;

Anggota

dwForwardDest

Jenis: DWORD

Alamat IPv4 tujuan rute. Entri dengan alamat IPv4 0.0.0.0 dianggap sebagai rute default. Anggota ini tidak dapat diatur ke alamat IPv4 multicast (kelas D).

dwForwardMask

Jenis: DWORD

Subnet mask IPv4 untuk digunakan dengan alamat IPv4 tujuan sebelum dibandingkan dengan nilai di anggota dwForwardDest .

Nilai dwForwardMask harus diterapkan ke alamat IPv4 tujuan (logis dan operasi) sebelum perbandingan dengan nilai di anggota dwForwardDest .

dwForwardPolicy

Jenis: DWORD

Serangkaian kondisi yang akan menyebabkan pemilihan rute multi-jalur (kumpulan hop berikutnya untuk tujuan tertentu). Anggota ini biasanya dalam format IP TOS. Pengodean anggota ini dijelaskan dalam RFC 1354. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc1354.txt.

dwForwardNextHop

Jenis: DWORD

Untuk rute jarak jauh, alamat IPv4 dari sistem berikutnya dalam rute. Jika tidak, anggota ini harus menjadi alamat IPv4 0.0.0.0.

dwForwardIfIndex

Jenis: DWORD

Indeks antarmuka lokal tempat lompatan berikutnya dari rute ini harus dicapai.

dwForwardType

Jenis: DWORD

Jenis rute seperti yang dijelaskan dalam RFC 1354. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc1354.txt.

Anggota ini dapat menjadi salah satu nilai yang ditentukan dalam file header Iprtmib.h .

Pada Windows Vista dan yang lebih baru, file header diatur ulang dan anggota ini bisa menjadi salah satu nilai dari jenis enumerasi MIB_IPFORWARD_TYPE yang ditentukan dalam file header Ipmib.h . Perhatikan bahwa header Ipmib.h secara otomatis disertakan oleh file header Iprtrmib.h yang secara otomatis disertakan oleh header Iphlpapi.h . File header Iprtrmib.h dan Ipmib.h tidak boleh digunakan secara langsung.

Daftar berikut ini memperlihatkan nilai yang mungkin untuk anggota ini.

Nilai	Makna
MIB_IPROUTE_TYPE_OTHER 1	Beberapa jenis lain yang tidak ditentukan dalam RFC 1354.
MIB_IPROUTE_TYPE_INVALID 2	Rute yang tidak valid. Nilai ini dapat dihasilkan dari rute yang ditambahkan oleh pengalihan ICMP.
MIB_IPROUTE_TYPE_DIRECT 3	Rute lokal tempat lompatan berikutnya adalah tujuan akhir (antarmuka lokal).
MIB_IPROUTE_TYPE_INDIRECT 4	Rute jarak jauh di mana lompatan berikutnya bukan tujuan akhir (tujuan jarak jauh).

ForwardType

dwForwardProto

Jenis: DWORD

Protokol atau mekanisme perutean yang menghasilkan rute seperti yang dijelaskan dalam RFC 1354. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc1354.txt. Lihat Pengidentifikasi Protokol untuk daftar kemungkinan pengidentifikasi protokol yang digunakan oleh protokol perutean.

Anggota ini dapat menjadi salah satu nilai yang ditentukan dalam file header Iprtmib.h . Nilai untuk anggota ini dapat menjadi salah satu nilai MIB_IPPROTO_xxx yang ditentukan dalam file header Iprtmib.h atau salah satu nilai PROTO_IP_xxx yang ditentukan dalam file header routprot.h karena nilai-nilai ini sama.

Pada Windows Vista dan yang lebih baru, file header diorganisasi ulang dan anggota ini bisa menjadi salah satu nilai yang ditentukan dalam file header Nldef.h . 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	Beberapa protokol lain tidak ditentukan dalam RFC 1354.
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 CreateIpForwardEntry, DeleteIpForwardEntry, atau SetIpForwardEntry .
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 Sistem Menengah ke Sistem Menengah (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	Bolt, Beranek, dan Newman (BBN) Interior Gateway Protocol (IGP) 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 yang 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 spesifik Windows yang ditambahkan sebagai rute statis dari antarmuka pengguna perutean atau perintah perutean, kecuali rute ini tidak menyebabkan Dial On Demand (DOD).

ForwardProto

dwForwardAge

Jenis: DWORD

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

dwForwardNextHopAS

Jenis: DWORD

Nomor sistem otonom lompatan berikutnya. Ketika anggota ini tidak diketahui atau tidak relevan dengan protokol atau mekanisme perutean yang ditentukan dalam dwForwardProto, nilai ini harus diatur ke nol. Nilai ini didokumenkan dalam RFC 1354. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc1354.txt

dwForwardMetric1

Jenis: DWORD

Nilai metrik perutean utama untuk rute ini. Semantik metrik ini ditentukan oleh protokol perutean yang ditentukan dalam anggota dwForwardProto . Jika metrik ini tidak digunakan, nilainya harus diatur ke -1. Nilai ini didokumenkan dalam RFC 1354. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc1354.txt

dwForwardMetric2

Jenis: DWORD

Nilai metrik perutean alternatif untuk rute ini. Semantik metrik ini ditentukan oleh protokol perutean yang ditentukan dalam anggota dwForwardProto . Jika metrik ini tidak digunakan, nilainya harus diatur ke -1. Nilai ini didokumenkan dalam RFC 1354. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc1354.txt

dwForwardMetric3

Jenis: DWORD

dwForwardMetric4

Jenis: DWORD

dwForwardMetric5

Jenis: DWORD

Keterangan

Fungsi GetIpForwardTable menghitung entri rute IPv4 pada sistem lokal dan mengembalikan informasi ini dalam struktur MIB_IPFORWARDTABLE yang berisi array entri struktur MIB_IPFORWARDROW .

Anggota dwForwardDest, dwForwardMask, dan dwForwardNextHop dari struktur MIB_IPFORWARDROW mewakili alamat IPv4 dalam urutan byte jaringan.

Anggota dwForwardProto dari struktur MIB_IPFORWARDROW menentukan protokol atau mekanisme perutean yang menghasilkan rute. Pengidentifikasi protokol perutean digunakan untuk mengidentifikasi informasi rute untuk protokol perutean yang ditentukan. Misalnya, MIB_IPPROTO_NETMGMT digunakan untuk mengidentifikasi informasi rute untuk perutean IP yang diatur melalui manajemen jaringan seperti Dynamic Host Configuration Protocol (DCHP), Simple Network Management Protocol (SNMP), atau dengan panggilan ke fungsi CreateIpForwardEntry, DeleteIpForwardEntry , atau SetIpForwardEntry . Lihat Pengidentifikasi Protokol untuk daftar kemungkinan protokol dan mekanisme perutean.

Alamat IPv4 0.0.0.0 di anggota dwForwardDest dari struktur MIB_IPFORWARDROW dianggap sebagai rute default. MIB_IPFORWARDTABLE mungkin berisi beberapa entri MIB_IPFORWARDROW dengan anggota dwForwardDest diatur ke 0.0.0.0 ketika ada beberapa adaptor jaringan yang diinstal.

Ketika dwForwardAge diatur ke INFINITE, rute tidak akan dihapus berdasarkan batas waktu

Nilai. Nilai lain untuk dwForwardAge menentukan jumlah detik sejak rute ditambahkan atau dimodifikasi dalam tabel perutean jaringan.

Pada Windows Server 2003 atau Windows 2000 Server saat Routing dan Remote Access Service (RRAS) berjalan, entri MIB_IPFORWARDROW yang dikembalikan memiliki anggota dwForwardType dan dwForwardAge yang diatur ke nol.

Pada Windows Vista dan Windows Server 2008, metrik rute yang ditentukan dalam anggota dwForwardMetric1 dari struktur MIB_IPFORWARDROW mewakili kombinasi metrik rute yang ditambahkan ke metrik antarmuka yang ditentukan dalam anggota Metrik dari struktur MIB_IPINTERFACE_ROW antarmuka terkait. Jadi anggota dwForwardMetric1 dari struktur MIB_IPFORWARDROW harus sama dengan atau lebih besar dari anggota Metrik dari struktur MIB_IPINTERFACE_ROW terkait. Jika aplikasi ingin mengatur metrik rute ke 0, maka anggota dwForwardMetric1 dari struktur MIB_IPFORWARDROW harus diatur sama dengan nilai metrik antarmuka yang ditentukan dalam anggota Metrik dari struktur MIB_IPINTERFACE_ROW terkait. Aplikasi dapat mengambil metrik antarmuka dengan memanggil fungsi GetIpInterfaceEntry .

Sejumlah anggota struktur MIB_IPFORWARDROW saat ini tidak digunakan oleh perutean IPv4. Anggota ini termasuk dwForwardPolicy, dwForwardNextHopAS, dwForwardMetric2, dwForwardMetric3, dwForwardMetric4, dan dwForwardMetric5.

Pada Kit Pengembangan Perangkat Lunak (SDK) Microsoft Windows yang dirilis untuk Windows Vista dan yang lebih baru, organisasi file header telah berubah. Struktur ini didefinisikan dalam file header Ipmib.h , bukan dalam file header Iprtrmib.h . Perhatikan bahwa file header Ipmib.h secara otomatis disertakan dalam Iprtrmib.h, yang secara otomatis disertakan dalam file header Iphlpapi.h . File header Ipmib.h dan Iprtrmib.h tidak boleh digunakan secara langsung.

Contoh

Untuk melihat contoh yang mengambil struktur MIB_IPFORWARDTABLE lalu mencetak entri struktur MIB_IPFORWARDROW dalam tabel ini, lihat fungsi GetIpForwardTable .

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	ipmib.h (termasuk Iphlpapi.h)