Fungsi CreateIpNetEntry2

Artikel
06/15/2023

Fungsi CreateIpNetEntry2 membuat entri alamat IP tetangga baru di komputer lokal.

Sintaks

NETIOAPI_API CreateIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

Parameter

Baris [in]
Penunjuk ke entri struktur MIB_IPNET_ROW2 untuk entri rute IP.

Menampilkan nilai

CreateIpNetEntry2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.

Jika fungsi gagal, CreateIpNetEntry2 mengembalikan salah satu kode kesalahan berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika salah satu item berikut terjadi: Penunjuk NULL diteruskan dalam parameter Baris . Anggota Alamat dari struktur MIB_IPNET_ROW2 yang ditunjuk parameter Baris tidak diatur ke alamat unicast, anycast, atau multicast IPv4 atau IPv6 yang valid. Anggota PhysicalAddress dan PhysicalAddressLength dari struktur MIB_IPNET_ROW2 tidak diatur ke alamat fisik yang valid. Anggota InterfaceLuid dan InterfaceIndex dari struktur MIB_IPNET_ROW2 tidak ditentukan. Alamat loopback diteruskan di anggota Alamat .
STATUS_NOT_FOUND	Antarmuka yang ditentukan tidak dapat ditemukan. Kesalahan ini dikembalikan jika fungsi tidak dapat menemukan antarmuka jaringan yang ditentukan oleh anggota InterfaceLuid atau InterfaceIndex dari 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 anggota Alamat dari struktur MIB_IPNET_ROW2 yang ditunjukkan parameter Baris , atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan di anggota Alamat .
ERROR_OBJECT_ALREADY_EXISTS	Objek sudah ada. Kesalahan ini dikembalikan jika anggota Alamat dari struktur MIB_IPNET_ROW2 yang ditunjuk parameter Baris adalah duplikat alamat IP tetangga yang ada pada antarmuka yang ditentukan oleh anggota InterfaceLuid atau InterfaceIndex dari struktur MIB_IPNET_ROW2.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Driver Anda harus menginisialisasi anggota struktur MIB_IPNET_ROW2 berikut yang ditunjuk oleh parameter Baris :

Atur anggota Alamat ke alamat dan keluarga IPv4 atau IPv6 unicast, anycast, atau multicast yang valid.
Atur anggota PhysicalAddress dan PhysicalAddressLength dalam struktur MIB_IPNET_ROW2 ke alamat fisik yang valid.
Atur InterfaceLuid atau InterfaceIndex ke LUID atau nilai indeks antarmuka.

Anggota InterfaceLuid dan InterfaceIndex 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 berikutnya digunakan untuk menentukan antarmuka.

Fungsi CreateIpNetEntry2 gagal jika alamat IP yang diteruskan di anggota Alamat dari struktur MIB_IPNET_ROW2 yang ditunjuk parameter Baris adalah duplikat alamat IP tetangga yang ada pada antarmuka.

Persyaratan

Platform target	Universal
Versi	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	Netioapi.h (termasuk Netioapi.h)
Pustaka	Netio.lib
IRQL	< DISPATCH_LEVEL