struktur MIB_IPINTERFACE_ROW (netioapi.h)
Struktur MIB_IPINTERFACE_ROW menyimpan informasi manajemen antarmuka untuk keluarga alamat IP tertentu pada antarmuka jaringan.
Sintaks
typedef struct _MIB_IPINTERFACE_ROW {
ADDRESS_FAMILY Family;
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
ULONG MaxReassemblySize;
ULONG64 InterfaceIdentifier;
ULONG MinRouterAdvertisementInterval;
ULONG MaxRouterAdvertisementInterval;
BOOLEAN AdvertisingEnabled;
BOOLEAN ForwardingEnabled;
BOOLEAN WeakHostSend;
BOOLEAN WeakHostReceive;
BOOLEAN UseAutomaticMetric;
BOOLEAN UseNeighborUnreachabilityDetection;
BOOLEAN ManagedAddressConfigurationSupported;
BOOLEAN OtherStatefulConfigurationSupported;
BOOLEAN AdvertiseDefaultRoute;
NL_ROUTER_DISCOVERY_BEHAVIOR RouterDiscoveryBehavior;
ULONG DadTransmits;
ULONG BaseReachableTime;
ULONG RetransmitTime;
ULONG PathMtuDiscoveryTimeout;
NL_LINK_LOCAL_ADDRESS_BEHAVIOR LinkLocalAddressBehavior;
ULONG LinkLocalAddressTimeout;
ULONG ZoneIndices[ScopeLevelCount];
ULONG SitePrefixLength;
ULONG Metric;
ULONG NlMtu;
BOOLEAN Connected;
BOOLEAN SupportsWakeUpPatterns;
BOOLEAN SupportsNeighborDiscovery;
BOOLEAN SupportsRouterDiscovery;
ULONG ReachableTime;
NL_INTERFACE_OFFLOAD_ROD TransmitOffload;
NL_INTERFACE_OFFLOAD_ROD ReceiveOffload;
BOOLEAN DisableDefaultRoutes;
} MIB_IPINTERFACE_ROW, *PMIB_IPINTERFACE_ROW;
Anggota
Family
Jenis: ADDRESS_FAMILY
Keluarga alamat. Nilai yang mungkin untuk keluarga alamat tercantum dalam file header Winsock2.h . Perhatikan bahwa nilai untuk keluarga alamat AF_ dan konstanta keluarga protokol PF_ identik (misalnya, AF_INET dan PF_INET), sehingga konstanta mana pun dapat digunakan.
Pada Windows Vista dan kemudian serta pada Windows SDK, organisasi file header telah berubah dan nilai yang mungkin untuk anggota ini didefinisikan dalam file header Ws2def.h . Perhatikan bahwa file header Ws2def.h secara otomatis disertakan dalam Winsock2.h, dan tidak boleh digunakan secara langsung.
Nilai yang saat ini didukung adalah AF_INET atau AF_INET6, yang merupakan format keluarga alamat Internet untuk IPv4 dan IPv6.
| Nilai | Makna |
|---|---|
|
Keluarga alamat tidak ditentukan. |
|
Keluarga alamat Protokol Internet versi 4 (IPv4). |
|
Keluarga alamat Protokol Internet versi 6 (IPv6). |
InterfaceLuid
Jenis: NET_LUID
Pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan.
InterfaceIndex
Jenis: NET_IFINDEX
Nilai indeks lokal untuk antarmuka jaringan. Nilai indeks ini dapat berubah ketika adaptor jaringan dinonaktifkan dan kemudian diaktifkan, atau dalam keadaan lain, dan tidak boleh dianggap persisten.
MaxReassemblySize
Jenis: ULONG
Ukuran rakitan ulang maksimum, dalam byte, dari paket IP terfragmentasi. Anggota ini saat ini diatur ke nol dan dicadangkan untuk digunakan di masa mendatang.
InterfaceIdentifier
Jenis: ULONG64
Disiapkan untuk penggunaan masa mendatang. Anggota ini saat ini diatur ke nol.
MinRouterAdvertisementInterval
Jenis: ULONG
Interval iklan router minimum, dalam milidetik, pada antarmuka IP ini. Anggota ini default ke 200 untuk IPv6. Anggota ini hanya berlaku jika anggota AdvertisingEnabled diatur ke TRUE.
MaxRouterAdvertisementInterval
Jenis: ULONG
Interval iklan router maksimum, dalam milidetik, pada antarmuka IP ini. Anggota ini default ke 600 untuk IPv6. Anggota ini hanya berlaku jika anggota AdvertisingEnabled diatur ke TRUE.
AdvertisingEnabled
Jenis: BOOLEAN
Nilai yang menunjukkan apakah iklan router diaktifkan pada antarmuka IP ini. Default untuk IPv6 adalah bahwa iklan router diaktifkan hanya jika antarmuka dikonfigurasi untuk bertindak sebagai router. Default untuk IPv4 adalah bahwa iklan router dinonaktifkan.
ForwardingEnabled
Jenis: BOOLEAN
Nilai yang menunjukkan apakah penerusan IP diaktifkan pada antarmuka IP ini.
WeakHostSend
Jenis: BOOLEAN
Nilai yang menunjukkan apakah mode pengiriman host yang lemah diaktifkan pada antarmuka IP ini.
WeakHostReceive
Jenis: BOOLEAN
Nilai yang menunjukkan apakah mode penerima host yang lemah diaktifkan pada antarmuka IP ini.
UseAutomaticMetric
Jenis: BOOLEAN
Nilai yang menunjukkan apakah antarmuka IP menggunakan metrik otomatis.
UseNeighborUnreachabilityDetection
Jenis: BOOLEAN
Nilai yang menunjukkan apakah deteksi ketidaktercapaian tetangga diaktifkan pada antarmuka IP ini.
ManagedAddressConfigurationSupported
Jenis: BOOLEAN
Nilai yang menunjukkan apakah antarmuka IP mendukung konfigurasi alamat terkelola menggunakan DHCP.
OtherStatefulConfigurationSupported
Jenis: BOOLEAN
Nilai yang menunjukkan apakah antarmuka IP mendukung konfigurasi stateful lainnya (konfigurasi rute, misalnya).
AdvertiseDefaultRoute
Jenis: BOOLEAN
Nilai yang menunjukkan apakah antarmuka IP mengiklankan rute default. Anggota ini hanya berlaku jika anggota AdvertisingEnabled diatur ke TRUE.
RouterDiscoveryBehavior
Jenis: NL_ROUTER_DISCOVERY_BEHAVIOR
Perilaku penemuan router. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NL_ROUTER_DISCOVERY_BEHAVIOR yang ditentukan dalam file header Nldef.h . Anggota dijelaskan dalam RFC 2461. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2461.txt.
DadTransmits
Jenis: ULONG
Jumlah pesan berturut-turut yang dikirim saat melakukan deteksi alamat duplikat pada alamat unicast IP tentatif. Nilai nol menunjukkan bahwa deteksi alamat duplikat tidak dilakukan pada alamat IP tentatif. Nilai satu menunjukkan satu transmisi tanpa menindaklanjuti transmisi ulang. Untuk IPv4, default untuk anggota ini adalah 3. Untuk IPv6, default untuk anggota ini adalah 1. Untuk IPv6, pesan-pesan ini akan dikirim sebagai permintaan ajakan tetangga. Anggota ini didefinisikan sebagai DupAddrDetectTransmits di RFC 2462. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2462.txt.
BaseReachableTime
Jenis: ULONG
Basis untuk waktu yang dapat dijangkau secara acak, dalam milidetik. Anggota dijelaskan dalam RFC 2461. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2461.txt.
RetransmitTime
Jenis: ULONG
Batas waktu permintaan tetangga, dalam milidetik. Anggota dijelaskan dalam RFC 2461. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2461.txt.
PathMtuDiscoveryTimeout
Jenis: ULONG
Batas waktu penemuan MTU jalur, dalam milidetik.
LinkLocalAddressBehavior
Jenis: NL_LINK_LOCAL_ADDRESS_BEHAVIOR
Tautan perilaku alamat lokal. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NL_LINK_LOCAL_ADDRESS_BEHAVIOR yang ditentukan dalam file header Nldef.h .
LinkLocalAddressTimeout
Jenis: ULONG
Tautan batas waktu alamat IP lokal, dalam milidetik.
ZoneIndices[ScopeLevelCount]
Jenis: ULONG[ScopeLevelCount]
Array yang menentukan bagian zona DARI ID cakupan.
SitePrefixLength
Jenis: ULONG
Panjang awalan situs, dalam bit, dari alamat antarmuka IP. Panjangnya, dalam bit, dari awalan situs atau bagian jaringan dari alamat antarmuka IP. Untuk alamat IPv4, nilai apa pun yang lebih besar dari 32 adalah nilai ilegal. Untuk alamat IPv6, nilai apa pun yang lebih besar dari 128 adalah nilai ilegal. Nilai 255 umumnya digunakan untuk mewakili nilai ilegal.
Metric
Jenis: ULONG
Metrik antarmuka. Perhatikan metrik rute aktual yang digunakan untuk menghitung preferensi rute adalah penjumlahan offset metrik rute yang ditentukan dalam anggota Metrik struktur MIB_IPFORWARD_ROW2 dan metrik antarmuka yang ditentukan dalam anggota ini.
NlMtu
Jenis: ULONG
Ukuran MTU lapisan jaringan, dalam byte.
Connected
Jenis: BOOLEAN
Nilai yang menunjukkan apakah antarmuka terhubung ke titik akses jaringan.
SupportsWakeUpPatterns
Jenis: BOOLEAN
Nilai yang menentukan apakah antarmuka jaringan mendukung Wake on LAN.
SupportsNeighborDiscovery
Jenis: BOOLEAN
Nilai yang menentukan apakah antarmuka IP mendukung penemuan tetangga.
SupportsRouterDiscovery
Jenis: BOOLEAN
Nilai yang menentukan apakah antarmuka IP mendukung penemuan router.
ReachableTime
Jenis: ULONG
Batas waktu yang dapat dijangkau, dalam milidetik.
TransmitOffload
Jenis: NL_INTERFACE_OFFLOAD_ROD
Sekumpulan bendera yang menunjukkan kemampuan transmisi offload untuk antarmuka IP. Struktur NL_INTERFACE_OFFLOAD_ROD ditentukan dalam file header Nldef.h .
ReceiveOffload
Jenis: NL_INTERFACE_OFFLOAD_ROD
Sekumpulan bendera yang menunjukkan kemampuan offload penerima untuk antarmuka IP. Struktur NL_INTERFACE_OFFLOAD_ROD ditentukan dalam file header Nldef.h .
DisableDefaultRoutes
Jenis: BOOLEAN
Nilai yang menunjukkan apakah menggunakan rute default pada antarmuka harus dinonaktifkan. Anggota ini dapat digunakan oleh klien VPN untuk membatasi penerowongan terpisah.
Keterangan
Struktur MIB_IPINTERFACE_ROW didefinisikan pada Windows Vista dan yang lebih baru.
Anggota Family, InterfaceLuid, dan InterfaceIndex secara unik mengidentifikasi entri MIB_IPINTERFACE_ROW .
Ketika paket unicast tiba di host, IP harus menentukan apakah paket ditujukan secara lokal (tujuannya cocok dengan alamat yang ditetapkan ke antarmuka host). Implementasi IP yang mengikuti model host yang lemah menerima paket yang ditujukan secara lokal, terlepas dari antarmuka tempat paket diterima. Implementasi IP yang mengikuti model host yang kuat hanya menerima paket yang ditentukan secara lokal jika alamat tujuan dalam paket cocok dengan alamat yang ditetapkan ke antarmuka tempat paket diterima. Model host yang lemah menyediakan konektivitas jaringan yang lebih baik. Namun, itu juga membuat host rentan terhadap serangan jaringan berbasis multihome.
Implementasi IPv4 saat ini di Windows Server 2003 dan Windows XP menggunakan model host yang lemah. Dalam hal ini, semua paket unicast dikirim keluar antarmuka dengan metrik terendah untuk rute.
Tumpukan TCP/IP pada Windows Vista dan kemudian mendukung model host yang kuat untuk IPv4 dan IPv6 dan dikonfigurasi untuk menggunakan mode host yang kuat secara default (anggota WeakHostReceive dan WeakHostSend diatur ke FALSE). Dengan mode host yang kuat, paket unicast dapat dikirim keluar antarmuka tertentu yang tidak memiliki metrik terendah untuk rute dengan mengikat soket ke alamat sumber antarmuka tertentu.
Tumpukan TCP/IP pada Windows Vista dan nantinya dapat dikonfigurasi untuk menggunakan model host yang lemah.
Metrik 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 ( UseAutomaticMetric diatur ke TRUE) pada Windows XP dan yang lebih baru. Ini juga dapat dikonfigurasi secara manual untuk menetapkan metrik tertentu ke rute IP.
Fitur metrik otomatis dapat berguna saat tabel perutean berisi beberapa rute untuk tujuan yang sama. Misalnya, komputer dengan antarmuka jaringan 10 megabit dan antarmuka jaringan 100 megabit memiliki gateway default yang dikonfigurasi pada kedua antarmuka jaringan. Ketika UseAutomaticMetricTRUE, fitur ini dapat memaksa semua lalu lintas yang ditujukan untuk Internet, misalnya, untuk menggunakan antarmuka jaringan tercepat yang tersedia.
Metrik antarmuka yang ditentukan dalam anggota Metrik hanya mewakili metrik untuk antarmuka. Metrik perutean lengkap adalah kombinasi dari metrik antarmuka ini yang ditambahkan ke offset metrik rute yang ditentukan dalam anggota Metrik dari struktur MIB_IPFORWARD_ROW2 entri rute yang ditentukan pada antarmuka ini.
Akses simultan yang tidak istimewa ke beberapa jaringan dengan persyaratan keamanan yang berbeda menciptakan lubang keamanan dan memungkinkan aplikasi yang tidak istimewa untuk secara tidak sengaja menyampaikan data antara kedua jaringan. Contoh umumnya adalah akses simultan ke jaringan privat virtual (VPN) dan internet. Windows Server 2003 dan Windows XP menggunakan model host yang lemah, di mana RAS mencegah akses simultan tersebut dengan meningkatkan metrik rute semua rute default melalui antarmuka lain. Dengan demikian semua lalu lintas dirutekan melalui antarmuka VPN, mengganggu konektivitas jaringan lainnya.
Pada Windows Vista dan yang lebih baru, model host yang kuat digunakan secara default. Jika alamat IP sumber ditentukan dalam pencarian rute menggunakan GetBestRoute2 atau GetBestRoute, pencarian rute dibatasi untuk antarmuka alamat IP sumber. Modifikasi metrik rute oleh RAS tidak berpengaruh karena daftar rute potensial bahkan tidak memiliki rute untuk antarmuka VPN sehingga memungkinkan lalu lintas ke internet. Anggota DisableDefaultRoutes dari struktur MIB_IPINTERFACE_ROW dapat digunakan untuk menonaktifkan menggunakan rute default pada antarmuka. Anggota ini dapat digunakan sebagai langkah keamanan oleh klien VPN untuk membatasi penerowongan terpisah saat penerowongan terpisah tidak diperlukan oleh klien VPN. Klien VPN dapat memanggil fungsi SetIpInterfaceEntry untuk mengatur anggota DisableDefaultRoutes ke TRUE jika diperlukan. Klien VPN dapat mengkueri status anggota DisableDefaultRoutes saat ini 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.
Contoh
Untuk melihat contoh yang mengambil struktur MIB_IPINTERFACE_TABLE lalu mencetak beberapa anggota entri struktur MIB_IPINTERFACE_ROW dalam tabel ini, lihat fungsi GetIpInterfaceTable .
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) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk