Fungsi CreateIpNetEntry2
Fungsi CreateIpNetEntry2 membuat entri alamat IP tetangga baru di komputer lokal.
Sintaksis
NETIOAPI_API CreateIpNetEntry2(
_In_ const MIB_IPNET_ROW2 *Row
);
Parameter
-
Baris [di]
Penunjuk ke entri struktur MIB_IPNET_ROW2 untuk entri rute IP.
Mengembalikan nilai
CreateIpNetEntry2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, CreateIpNetEntry2 mengembalikan salah satu kode kesalahan berikut:
| Mengembalikan kode | Deskripsi |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika salah satu item berikut terjadi:
|
| STATUS_NOT_FOUND | Antarmuka yang ditentukan tidak dapat ditemukan. Kesalahan ini dikembalikan jika fungsi tidak dapat menemukan antarmuka jaringan yang ditentukan oleh InterfaceLuid atau InterfaceIndex anggota struktur MIB_IPNET_ROW2 yang ditunjuk oleh parameter Baris. |
| STATUS_NOT_SUPPORTED | Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 yang terletak di komputer lokal dan alamat IPv4 ditentukan dalam Alamat anggota struktur MIB_IPNET_ROW2 yang baris titik parameter, atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan dalam Alamat anggota. |
| ERROR_OBJECT_ALREADY_EXISTS | Objek sudah ada. Kesalahan ini dikembalikan jika alamat anggota struktur MIB_IPNET_ROW2 yang ditunjukkan parameter Baris adalah duplikat alamat IP tetangga yang ada pada antarmuka yang ditentukan oleh InterfaceLuid atau InterfaceIndex anggota struktur MIB_IPNET_ROW2. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Komentar
Driver Anda harus menginisialisasi anggota struktur MIB_IPNET_ROW2 berikut yang ditunjukkan oleh parameter Baris:
Atur alamat anggota ke alamat dan keluarga IPv4 atau IPv6 unicast, anycast, atau multicast yang valid.
Atur PhysicalAddress dan anggota PhysicalAddressLength dalam struktur MIB_IPNET_ROW2 ke alamat fisik yang valid.
Atur InterfaceLuid atau InterfaceIndex ke LUID atau nilai indeks antarmuka.
InterfaceLuid dan InterfaceIndex anggota digunakan dalam urutan yang tercantum sebelumnya. Jadi, jika InterfaceLuid ditentukan, anggota ini digunakan untuk menentukan antarmuka untuk menambahkan alamat IP unicast. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.
Fungsi CreateIpNetEntry2 gagal jika alamat IP yang diteruskan di Alamat anggota struktur MIB_IPNET_ROW2 yang ditunjukkan parameter Baris adalah duplikat alamat IP tetangga yang ada pada antarmuka.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Perpustakaan |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |