Fungsi FlushIpNetTable2
Fungsi FlushIpNetTable2 membersihkan tabel tetangga IP di komputer lokal.
Sintaksis
NETIOAPI_API FlushIpNetTable2(
_In_ ADDRESS_FAMILY Family,
_In_ NET_IFINDEX InterfaceIndex
);
Parameter
Family [in]
Keluarga alamat untuk disikat.Nilai yang mungkin untuk keluarga alamat tercantum dalam file header Winsock2.h. Perhatikan bahwa nilai untuk keluarga alamat AF_ dan konstanta keluarga protokol PF_ identik (misalnya, AF_INET dan PF_INET), sehingga Anda dapat menggunakan konstanta.
Pada Windows Vista dan versi sistem operasi Windows yang lebih baru, nilai yang mungkin untuk parameter Keluarga didefinisikan dalam file header Ws2def.h. Perhatikan bahwa file header Ws2def.h secara otomatis disertakan dalam Netioapi.h dan Anda tidak boleh menggunakan Ws2def.h secara langsung.
Nilai berikut saat ini didukung untuk keluarga alamat:
AF_INET
Keluarga alamat IPv4. Ketika nilai ini ditentukan, fungsi ini menghapus tabel alamat IP tetangga yang hanya berisi entri IPv4.AF_INET6
Keluarga alamat IPv6. Ketika nilai ini ditentukan, fungsi ini menghapus tabel alamat IP tetangga yang hanya berisi entri IPv6.AF_UNSPEC
Keluarga alamat tidak ditentukan. Ketika nilai ini ditentukan, fungsi ini menghapus tabel alamat IP tetangga yang berisi entri IPv4 dan IPv6.
InterfaceIndex [in]
Indeks antarmuka. Jika indeks ditentukan, fungsi akan menghapus entri alamat IP tetangga pada antarmuka tertentu. Ootherwise, fungsi membersihkan entri alamat IP tetangga pada semua antarmuka. Untuk mengabaikan antarmuka, atur parameter ini ke nol.
Mengembalikan nilai
FlushIpNetTable2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, FlushIpNetTable2 mengembalikan salah satu kode kesalahan berikut:
| Mengembalikan kode | Deskripsi |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika parameter Keluarga tidak ditentukan sebagai AF_INET, AF_INET6, atau AF_UNSPEC. |
| STATUS_NOT_SUPPORTED | Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 yang terletak di komputer lokal dan AF_INET ditentukan dalam parameter Keluarga, atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan AF_INET6 ditentukan dalam parameter Family. Kesalahan ini juga dikembalikan pada versi Windows di mana fungsi ini tidak didukung. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Komentar
Fungsi FlushIpNetTable2 menghapus atau menghapus alamat IP tetangga di komputer lokal. Driver Anda dapat menggunakan parameter Keluarga untuk membatasi alamat IP tetangga untuk dihapus ke keluarga alamat IP tertentu. Jika alamat IP tetangga untuk IPv4 dan IPv6 harus dihapus, driver Anda harus mengatur parameter Keluarga ke AF_UNSPEC. Driver Anda dapat menggunakan parameter InterfaceIndex untuk membatasi alamat IP tetangga untuk dihapus ke antarmuka tertentu. Jika alamat IP tetangga untuk semua antarmuka harus dihapus, driver Anda harus mengatur parameter InterfaceIndex ke nol.
Driver Anda harus menginisialisasi parameter Keluarga ke AF_INET, AF_INET6, atau AF_UNSPEC.
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 |