Fungsi FlushIpNetTable (iphlpapi.h)

Artikel
03/14/2023

Fungsi FlushIpNetTable menghapus semua entri ARP untuk antarmuka yang ditentukan dari tabel ARP di komputer lokal.

Sintaks

IPHLPAPI_DLL_LINKAGE DWORD FlushIpNetTable(
  [in] DWORD dwIfIndex
);

Parameter

[in] dwIfIndex

Indeks antarmuka untuk menghapus semua entri ARP.

Nilai kembali

Fungsi mengembalikan NO_ERROR (nol) jika fungsi berhasil.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Akses ditolak. Kesalahan ini dikembalikan pada Windows Vista dan Windows Server 2008 dalam beberapa kondisi yang mencakup hal berikut: pengguna tidak memiliki hak administratif yang diperlukan di komputer lokal atau aplikasi tidak berjalan dalam shell yang ditingkatkan sebagai Administrator bawaan (administrator RunAs).
ERROR_INVALID_PARAMETER	Parameter input tidak valid, tidak ada tindakan yang diambil. Kesalahan ini dikembalikan jika parameter dwIfIndex tidak valid.
ERROR_NOT_SUPPORTED	Transportasi IPv4 tidak dikonfigurasi pada komputer lokal.
Lainnya	Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Untuk mengambil tabel ARP, panggil fungsi GetIpNetTable .

Pada Windows Vista dan yang lebih baru, fungsi FlushIpNetTable hanya dapat dipanggil oleh pengguna yang masuk sebagai anggota grup Administrator. Jika FlushIpNetTable dipanggil oleh pengguna yang bukan anggota grup Administrator, panggilan fungsi akan gagal dan ERROR_ACCESS_DENIED dikembalikan. Fungsi ini juga dapat gagal karena kontrol akun pengguna (UAC) pada Windows Vista dan yang lebih baru. Jika aplikasi yang berisi fungsi ini dijalankan oleh pengguna yang masuk sebagai anggota grup Administrator selain Administrator bawaan, panggilan ini akan gagal kecuali aplikasi telah ditandai dalam file manifes dengan requestedExecutionLevel yang diatur ke requireAdministrator. Jika aplikasi di Windows Vista dan kemudian tidak memiliki file manifes ini, pengguna yang masuk sebagai anggota grup Administrator selain Administrator bawaan kemudian harus menjalankan aplikasi dalam shell yang ditingkatkan sebagai Administrator bawaan (administrator RunAs) agar fungsi ini berhasil.

Catatan Fungsi ini menjalankan operasi istimewa. Agar fungsi ini berhasil dijalankan, pemanggil harus masuk sebagai anggota grup Administrator atau grup NetworkConfigurationOperators.

Persyaratan


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