Fungsi GetIpNetTable (iphlpapi.h)

Artikel
03/04/2024

Fungsi GetIpNetTable mengambil tabel pemetaan alamat IPv4 ke fisik.

Sintaks

IPHLPAPI_DLL_LINKAGE ULONG GetIpNetTable(
  [out]     PMIB_IPNETTABLE IpNetTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Parameter

[out] IpNetTable

Penunjuk ke buffer yang menerima tabel pemetaan IPv4 ke alamat fisik sebagai struktur MIB_IPNETTABLE .

[in, out] SizePointer

Pada input, menentukan ukuran dalam byte buffer yang diacu oleh parameter pIpNetTable .

Pada output, jika buffer tidak cukup besar untuk menahan tabel pemetaan yang dikembalikan, fungsi mengatur parameter ini sama dengan ukuran buffer yang diperlukan dalam byte.

[in] Order

Nilai Boolean yang menentukan apakah tabel pemetaan yang dikembalikan harus diurutkan dalam urutan naik menurut alamat IP. Jika parameter ini TRUE, tabel akan diurutkan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR atau ERROR_NO_DATA.

Jika fungsi gagal atau tidak mengembalikan data apa pun, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_INSUFFICIENT_BUFFER	Buffer yang diacu oleh parameter pIpNetTable tidak cukup besar. Ukuran yang diperlukan dikembalikan dalam variabel DWORD yang diarahkan oleh parameter pdwSize .
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika parameter pdwSize adalah NULL, atau GetIpNetTable tidak dapat menulis ke memori yang diarahkan oleh parameter pdwSize .
ERROR_NO_DATA	Tidak ada data untuk dikembalikan. Tabel pemetaan alamat IPv4 ke fisik kosong. Nilai pengembalian ini menunjukkan bahwa panggilan ke fungsi GetIpNetTable berhasil, tetapi tidak ada data untuk dikembalikan.
ERROR_NOT_SUPPORTED	Transportasi IPv4 tidak dikonfigurasi pada komputer lokal.
Lainnya	Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

The
Fungsi GetIpNetTable menghitung entri Protokol Resolusi Alamat (ARP) untuk IPv4 pada sistem lokal dari tabel pemetaan alamat IPv4 ke fisik dan mengembalikan informasi ini dalam struktur MIB_IPNETTABLE .

Entri alamat IPv4 dikembalikan dalam struktur MIB_IPNETTABLE dalam buffer yang ditujukkan oleh parameter pIpNetTable . Struktur MIB_IPNETTABLE berisi hitungan entri ARP dan array struktur MIB_IPNETROW untuk setiap entri alamat IPv4.

Perhatikan bahwa struktur MIB_IPNETTABLE yang dikembalikan yang diarahkan oleh parameter pIpNetTable mungkin berisi pengisi untuk perataan antara anggota dwNumEntries dan entri array MIB_IPNETROW pertama di anggota tabel struktur MIB_IPNETTABLE . Padding untuk perataan mungkin juga ada di antara entri array MIB_IPNETROW . Setiap akses ke entri array MIB_IPNETROW harus mengasumsikan padding mungkin ada.

pada Windows Vista dan yang lebih baru, fungsi GetIpNetTable2 dapat digunakan untuk mengambil alamat IP tetangga untuk IPv6 dan IPv4.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	iphlpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll