Fungsi SetIpNetEntry (iphlpapi.h)
Fungsi SetIpNetEntry memodifikasi entri ARP yang ada dalam tabel ARP di komputer lokal.
Sintaks
IPHLPAPI_DLL_LINKAGE DWORD SetIpNetEntry(
[in] PMIB_IPNETROW pArpEntry
);
Parameter
[in] pArpEntry
Penunjuk ke struktur MIB_IPNETROW . Informasi dalam struktur ini menentukan entri untuk memodifikasi dan informasi baru untuk entri. Pemanggil harus menentukan nilai untuk semua anggota struktur ini.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
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). |
|
Parameter pArpEntryadalah NULL, atau SetIpNetEntry tidak dapat membaca dari memori yang diarahkan oleh pArpEntry, atau salah satu anggota struktur MIB_IPNETROW tidak valid. |
|
Transportasi IPv4 tidak dikonfigurasi pada komputer lokal. |
|
Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Pada Windows Vista dan yang lebih baru , fungsi SetIpNetEntry hanya dapat dipanggil oleh pengguna yang masuk sebagai anggota grup Administrator. Jika SetIpNetEntry dipanggil oleh pengguna yang bukan anggota grup Administrator, panggilan fungsi akan gagal dan ERROR_ACCESS_DENIED dikembalikan.
Fungsi SetIpNetEntry 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 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.
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 |