Fungsi DeleteIpForwardEntry2

Fungsi DeleteIpForwardEntry2 menghapus entri rute IP di komputer lokal.

Sintaksis

NETIOAPI_API DeleteIpForwardEntry2(
  _In_ const MIB_IPFORWARD_ROW2 *Row
);

Parameter

• Baris [di]
  Penunjuk ke entri struktur MIB_IPFORWARD_ROW2 untuk entri rute IP. Pada pengembalian yang berhasil, entri ini dihapus.

Mengembalikan nilai

DeleteIpForwardEntry2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.

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

Mengembalikan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris, DestinationPrefix anggota struktur MIB_IPFORWARD_ROW2 yang ditunjukkan parameter Baris tidak ditentukan, NextHop anggota struktur MIB_IPFORWARD_ROW2 tidak ditentukan, atau InterfaceLuid dan InterfaceIndex anggota struktur MIB_IPFORWARD_ROW2 tidak ditentukan.
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_IPFORWARD_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_IPFORWARD_ROW2 yang ditunjuk parameter Baris, atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan di Alamat anggota.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

Fungsi DeleteIpForwardEntry2 digunakan untuk menghapus entri struktur MIB_IPFORWARD_ROW2.

Pada input, driver Anda harus menginisialisasi anggota struktur MIB_IPFORWARD_ROW2 berikut yang ditunjukkan oleh parameter Baris.

• DestinationPrefix
  Atur ke awalan alamat dan keluarga IPv4 atau IPv6 yang valid.

• NextHop
  Atur ke alamat dan keluarga IPv4 atau IPv6 yang valid.

• InterfaceLuid atau InterfaceIndex
  Anggota ini digunakan dalam urutan yang tercantum sebelumnya. Jadi jika InterfaceLuid ditentukan, anggota ini digunakan untuk menentukan antarmuka. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.

Pada output, ketika panggilan berhasil, DeleteIpForwardEntry2 menghapus entri rute IP.

Fungsi DeleteIpForwardEntry2 gagal jika DestinationPrefix dan nextHop anggota struktur MIB_IPFORWARD_ROW2 yang ditunjuk parameter Baris tidak cocok dengan entri rute IP yang ada pada antarmuka yang ditentukan dalam InterfaceLuid atau interfaceIndex anggota.

Driver Anda dapat memanggil fungsiGetIpForwardTable2 untuk menghitung entri rute IP di komputer lokal.

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

Lihat juga

CreateIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

InitializeIpForwardEntry

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

setIpForwardEntry2