Fungsi FlushIpPathTable

Artikel
06/14/2023

Fungsi FlushIpPathTable membersihkan tabel jalur IP di komputer lokal.

Sintaks

NETIOAPI_API FlushIpPathTable(
  _In_ ADDRESS_FAMILY Family
);

Parameter

Keluarga [in]
Keluarga alamat untuk dibersihkan.

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 salah satu konstanta.

Pada Windows Vista dan versi sistem operasi Windows yang lebih baru, nilai yang mungkin untuk parameter Family ditentukan 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 jalur IP yang hanya berisi entri IPv4.
- AF_INET6
  Keluarga alamat IPv6. Ketika nilai ini ditentukan, fungsi ini menghapus tabel jalur IP 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.

Menampilkan nilai

FlushIpPathTable mengembalikan STATUS_SUCCESS jika fungsi berhasil.

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

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika parameter Family 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 Keluarga . 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.

Keterangan

Fungsi FlushIpPathTable menghapus atau menghapus entri jalur IP di komputer lokal. Driver Anda dapat menggunakan parameter Family untuk membatasi entri jalur IP untuk dihapus ke keluarga alamat IP tertentu. Jika entri jalur IP untuk IPv4 dan IPv6 harus dihapus, driver Anda harus mengatur parameter Family ke AF_UNSPEC.

Driver Anda harus menginisialisasi parameter Family untuk AF_INET, AF_INET6, atau AF_UNSPEC.

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

Bagikan melalui