Fungsi CreateIpNetEntry (iphlpapi.h)

Artikel
08/24/2023

Fungsi CreateIpNetEntry membuat entri Protokol Resolusi Alamat (ARP) dalam tabel ARP di komputer lokal.

Sintaks

IPHLPAPI_DLL_LINKAGE DWORD CreateIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parameter

[in] pArpEntry

Penunjuk ke struktur MIB_IPNETROW yang menentukan informasi untuk entri baru. Pemanggil harus menentukan nilai untuk semua anggota struktur ini.

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 pada 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 pArpEntry adalah NULL, anggota dwPhysAddrLendari MIB_IPNETROW diatur ke nol atau nilai yang lebih besar dari 8, >anggota dwAddr dari struktur MIB_IPNETROW tidak valid, atau salah satu anggota struktur MIB_IPNETROW lainnya 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 mengubah entri ARP yang ada, gunakan fungsi SetIpNetEntry . Untuk mengambil tabel ARP, panggil fungsi GetIpNetTable . Untuk menghapus entri ARP yang ada, panggil DeleteIpNetEntry.

Pada Windows Vista dan yang lebih baru, fungsi CreateIpNetEntry hanya dapat dipanggil oleh pengguna yang masuk sebagai anggota grup Administrator. Jika CreateIpNetEntry dipanggil oleh pengguna yang bukan anggota grup Administrator, panggilan fungsi akan gagal dan ERROR_ACCESS_DENIED dikembalikan.

Fungsi CreateIpNetEntry juga bisa gagal karena kontrol akun pengguna (UAC) di Windows Vista nanti. 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 diatur ke requireAdministrator. Jika aplikasi 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 Pada Windows NT 4.0 dan Windows 2000 dan yang lebih baru, 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