Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Fungsi CreateProxyArpEnry membuat entri Proxy Address Resolution Protocol (PARP) di komputer lokal untuk alamat IPv4 yang ditentukan.
Sintaks
IPHLPAPI_DLL_LINKAGE DWORD CreateProxyArpEntry(
[in] DWORD dwAddress,
[in] DWORD dwMask,
[in] DWORD dwIfIndex
);
Parameter
[in] dwAddress
Alamat IPv4 tempat komputer ini bertindak sebagai proksi.
[in] dwMask
Subnet mask untuk alamat IPv4 yang ditentukan dalam dwAddress.
[in] dwIfIndex
Indeks antarmuka untuk memproksi ARP untuk alamat IPv4 yang diidentifikasi oleh dwAddress. Dengan kata lain, ketika permintaan ARP untuk dwAddress diterima pada antarmuka ini, komputer lokal merespons dengan alamat fisik antarmuka ini. Jika antarmuka ini berjenis yang tidak mendukung ARP, seperti PPP, maka panggilan gagal.
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 |
|---|---|
|
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 input tidak valid, tidak ada tindakan yang diambil. Kesalahan ini dikembalikan jika parameter dwAddress adalah nol atau nilai yang tidak valid, salah satu parameter lainnya tidak valid. |
|
Transportasi IPv4 tidak dikonfigurasi pada komputer lokal. |
|
Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Untuk mengambil tabel ARP, panggil fungsi GetIpNetTable . Untuk menghapus entri PARP yang ada, panggil DeleteProxyArpEntry.
Pada Windows Vista dan yang lebih baru, fungsi CreateProxyArpEnry hanya dapat dipanggil oleh pengguna yang masuk sebagai anggota grup Administrator. Jika CreateProxyArpEnry 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 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 |