struktur MIB_IPNET_ROW2 (netioapi.h)

Artikel
08/25/2023

Struktur MIB_IPNET_ROW2 menyimpan informasi tentang alamat IP tetangga.

Sintaks

typedef struct _MIB_IPNET_ROW2 {
  SOCKADDR_INET     Address;
  NET_IFINDEX       InterfaceIndex;
  NET_LUID          InterfaceLuid;
  UCHAR             PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
  ULONG             PhysicalAddressLength;
  NL_NEIGHBOR_STATE State;
  union {
    struct {
      BOOLEAN IsRouter : 1;
      BOOLEAN IsUnreachable : 1;
    };
    UCHAR Flags;
  };
  union {
    ULONG LastReachable;
    ULONG LastUnreachable;
  } ReachabilityTime;
} MIB_IPNET_ROW2, *PMIB_IPNET_ROW2;

Anggota

Address

Jenis: SOCKADDR_INET

Alamat IP tetangga. Anggota ini bisa menjadi alamat IPv6 atau alamat IPv4.

InterfaceIndex

Jenis: NET_IFINDEX

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

InterfaceLuid

Jenis: NET_LUID

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

PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]

Jenis: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]

Alamat perangkat keras fisik adaptor untuk antarmuka jaringan yang terkait dengan alamat IP ini.

PhysicalAddressLength

Jenis: ULONG

Panjang, dalam byte, dari alamat perangkat keras fisik yang ditentukan oleh anggota PhysicalAddress . Nilai maksimum yang didukung adalah 32 byte.

State

Jenis: NL_NEIGHBOR_STATE

Status alamat IP tetangga jaringan seperti yang didefinisikan dalam RFC 2461, bagian 7.3.2. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2461.txt. Anggota ini dapat menjadi salah satu nilai dari jenis enumerasi NL_NEIGHBOR_STATE yang ditentukan dalam file header Nldef.h .

Nilai	Makna
NlnsUnreachable	Alamat IP tidak dapat dijangkau.
NlnsIncomplete	Resolusi alamat sedang berlangsung dan alamat lapisan tautan tetangga belum ditentukan. Khusus untuk IPv6, Permintaan Tetangga telah dikirim ke alamat IP multicast simpul yang diminta dari target, tetapi iklan tetangga yang sesuai belum diterima.
NlnsProbe	Tetangga tidak lagi diketahui dapat dijangkau, dan pemeriksaan dikirim untuk memverifikasi keterjangkauan. Untuk IPv6, konfirmasi keterjangkauan secara aktif sedang dicari dengan mengirimkan ulang pemeriksaan Permintaan Tetangga unicast secara berkala hingga konfirmasi keterjangkauan diterima.
NlnsDelay	Tetangga tidak lagi diketahui dapat dijangkau, dan lalu lintas baru-baru ini dikirim ke tetangga. Namun, alih-alih memeriksa tetangga segera, tunda pengiriman probe untuk sementara waktu untuk memberikan protokol lapisan atas kesempatan untuk memberikan konfirmasi keterjangkauan. Untuk IPv6, lebih banyak waktu telah berlalu daripada yang ditentukan dalam anggota ReachabilityTime.ReachableTime sejak konfirmasi positif terakhir diterima bahwa jalur penerusan berfungsi dengan baik dan paket dikirim. Jika tidak ada konfirmasi keterjangkauan yang diterima dalam jangka waktu tertentu (digunakan untuk menunda pemeriksaan pertama) untuk memasuki status NlnsDelay , maka ajakan tetangga dikirim dan anggota Negara diubah menjadi NlnsProbe.
NlnsStale	Tetangga tidak lagi diketahui dapat dijangkau tetapi sampai lalu lintas dikirim ke tetangga, tidak ada upaya yang harus dilakukan untuk memverifikasi keterjangkauannya. Untuk IPv6, lebih banyak waktu telah berlalu daripada yang ditentukan dalam anggota ReachabilityTime.ReachableTime sejak konfirmasi positif terakhir diterima bahwa jalur penerusan berfungsi dengan baik. Sementara Status adalah NlnsStale, tidak ada tindakan yang terjadi sampai paket dikirim. Status NlnsStale dimasukkan setelah menerima pesan penemuan tetangga yang tidak diminta yang memperbarui alamat IP yang di-cache. Tanda terima pesan tersebut tidak mengonfirmasi keterjangkauan, dan memasukkan status NlnsStale memastikan keterjangkauan diverifikasi dengan cepat jika entri benar-benar digunakan. Namun, keterjangkauan sebenarnya tidak diverifikasi sampai entri benar-benar digunakan.
NlnsReachable	Tetangga diketahui telah dapat dijangkau baru-baru ini (dalam puluhan detik yang lalu). Untuk IPv6, konfirmasi positif diterima dalam waktu yang ditentukan dalam anggota ReachabilityTime.ReachableTime bahwa jalur maju ke tetangga berfungsi dengan baik. Sementara Negara bagian adalah NlnsReachable, tidak ada tindakan khusus yang terjadi saat paket dikirim.
NlnsPermanent	Alamat IP adalah alamat permanen.
NlnsMaximum	Nilai maksimum yang mungkin untuk jenis enumerasi NL_NEIGHBOR_STATE . Ini bukan nilai hukum untuk anggota Negara .

IsRouter

Jenis: BOOLEAN

Nilai yang menunjukkan apakah alamat IP ini adalah router.

IsUnreachable

Jenis: BOOLEAN

Nilai yang menunjukkan apakah alamat IP ini tidak dapat dijangkau.

Flags

Jenis: UCHAR

Sekumpulan bendera yang menunjukkan apakah alamat IP adalah router dan apakah alamat IP tidak dapat dijangkau.

ReachabilityTime

ReachabilityTime.LastReachable

Jenis: ULONG Waktu, dalam milidetik, bahwa simpul mengasumsikan tetangga dapat dijangkau setelah menerima konfirmasi keterjangkauan.

ReachabilityTime.LastUnreachable

Jenis: ULONG Waktu, dalam milidetik, bahwa simpul mengasumsikan tetangga tidak dapat dijangkau setelah tidak menerima konfirmasi keterjangkauan.

Keterangan

Struktur MIB_IPNET_ROW2 didefinisikan pada Windows Vista dan yang lebih baru.

Fungsi GetIpNetTable2 menghitung alamat IP tetangga pada sistem lokal dan mengembalikan informasi ini dalam struktur MIB_IPNET_TABLE2 .

Untuk IPv4, ini termasuk alamat yang ditentukan menggunakan Protokol Resolusi Alamat (ARP). Untuk IPv6, ini termasuk alamat yang ditentukan menggunakan protokol Penemuan Tetangga (ND) untuk IPv6 seperti yang ditentukan dalam RFC 2461. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2461.txt.

Fungsi GetIpNetEntry2 mengambil satu alamat IP tetangga dan mengembalikan informasi ini dalam struktur MIB_IPNET_ROW2 .

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)

Lihat juga

Bagikan melalui