Fungsi GetIpNetEntry2
Fungsi GetIpNetEntry2 mengambil informasi untuk entri alamat IP tetangga di komputer lokal.
Sintaksis
NETIOAPI_API GetIpNetEntry2(
_Inout_ PMIB_IPNET_ROW2 Row
);
Parameter
-
Baris [masuk, keluar]
Penunjuk ke entri struktur MIB_IPNET_ROW2 untuk entri alamat IP tetangga. Pada pengembalian yang berhasil, struktur ini diperbarui dengan properti untuk alamat IP tetangga.
Mengembalikan nilai
GetIpNetEntry2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetIpNetEntry2 mengembalikan salah satu kode kesalahan berikut:
| Mengembalikan kode | Deskripsi |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris, Alamat anggota struktur MIB_IPNET_ROW2 yang ditunjukkan parameter Baris tidak diatur ke alamat IPv4 atau IPv6 tetangga yang valid, atau InterfaceLuid dan InterfaceIndex anggota struktur MIB_IPNET_ROW2 tidak ditentukan. |
| STATUS_NOT_FOUND | Antarmuka yang ditentukan tidak dapat ditemukan. Kesalahan ini dikembalikan jika fungsi tidak dapat menemukan antarmuka jaringan yang ditentukan oleh InterfaceLuid atau InterfaceIndex anggota struktur MIB_IPNET_ROW2 yang ditunjuk oleh parameter Baris. |
| STATUS_NOT_SUPPORTED | Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 yang terletak di komputer lokal dan alamat IPv4 ditentukan dalam Alamat anggota struktur MIB_IPNET_ROW2 yang ditunjuk parameter Baris, atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan dalam alamat anggota. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Komentar
Fungsi GetIpNetEntry2 digunakan untuk mengambil entri struktur MIB_IPNET_ROW2.
Pada input, driver Anda harus menginisialisasi anggota struktur MIB_IPNET_ROW2 berikut yang ditunjuk oleh parameter Row.
Alamat
Atur ke alamat dan keluarga IPv4 atau IPv6 tetangga yang valid.InterfaceLuid atau InterfaceIndex
Anggota ini digunakan dalam urutan yang tercantum sebelumnya. Jadi jika InterfaceLuid ditentukan, anggota ini digunakan untuk menentukan antarmuka. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.
Pada output, ketika panggilan berhasil, GetIpNetEntry2 mengambil properti lain untuk alamat IP tetangga dan mengisi struktur MIB_IPNET_ROW2 yang ditunjuk oleh parameter Baris.
Driver Anda dapat memanggil fungsiGetIpNetTable2 untuk menghitung entri alamat IP tetangga di komputer lokal.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Perpustakaan |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |