Fungsi DeleteIpForwardEntry2
Fungsi DeleteIpForwardEntry2 menghapus entri rute IP di komputer lokal.
Sintaks
NETIOAPI_API DeleteIpForwardEntry2(
_In_ const MIB_IPFORWARD_ROW2 *Row
);
Parameter
- Baris [in]
Penunjuk ke entri struktur MIB_IPFORWARD_ROW2 untuk entri rute IP. Saat pengembalian berhasil, entri ini dihapus.
Mengembalikan nilai
DeleteIpForwardEntry2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, DeleteIpForwardEntry2 mengembalikan salah satu kode kesalahan berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris , anggota DestinationPrefix dari struktur MIB_IPFORWARD_ROW2 yang ditunjuk parameter Baris tidak ditentukan, anggota NextHop dari struktur MIB_IPFORWARD_ROW2 tidak ditentukan, atau anggota InterfaceLuid dan InterfaceIndex dari 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 anggota InterfaceLuid atau InterfaceIndex dari struktur MIB_IPFORWARD_ROW2 yang ditunjuk 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 di anggota Alamat struktur MIB_IPFORWARD_ROW2 yang ditunjuk parameter Baris , atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan di anggota Alamat . |
Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi DeleteIpForwardEntry2 digunakan untuk menghapus entri struktur MIB_IPFORWARD_ROW2 .
Pada input, driver Anda harus menginisialisasi anggota struktur MIB_IPFORWARD_ROW2 berikut yang ditunjuk 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 berikutnya digunakan untuk menentukan antarmuka.
Pada output, ketika panggilan berhasil, DeleteIpForwardEntry2 menghapus entri rute IP.
Fungsi DeleteIpForwardEntry2 gagal jika anggota DestinationPrefix dan NextHop dari struktur MIB_IPFORWARD_ROW2 yang ditunjuk parameter Baris tidak cocok dengan entri rute IP yang ada pada antarmuka yang ditentukan dalam anggota InterfaceLuid atau InterfaceIndex .
Driver Anda dapat memanggil fungsi GetIpForwardTable2 untuk menghitung entri rute IP di komputer lokal.
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk