Fungsi FwpsQueryPacketInjectionState0 (fwpsk.h)

Artikel
02/26/2024

Fungsi FwpsQueryPacketInjectionState0 dipanggil oleh callout untuk mengkueri status injeksi data paket.

CatatanFwpsQueryPacketInjectionState0 adalah versi tertentu dari FwpsQueryPacketInjectionState. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
  [in]            HANDLE                injectionHandle,
  [in]            const NET_BUFFER_LIST *netBufferList,
  [out, optional] HANDLE                *injectionContext
);

Parameter

[in] injectionHandle

Handel injeksi yang sebelumnya dibuat oleh panggilan ke Fungsi FwpsInjectionHandleCreate0 .

[in] netBufferList

Penunjuk ke struktur NET_BUFFER_LIST yang menjelaskan data paket yang sedang diklasifikasikan. Paket dapat berasal dari tumpukan jaringan, atau dapat disuntikkan ke tumpukan jaringan oleh driver callout WFP.

[out, optional] injectionContext

Handel opsional ke konteks injeksi. Jika penunjuk ditentukan, dan jika status injeksi paket FWPS_PACKET_INJECTION_STATE terkait dengan handel injeksi FWPS_PACKET_INJECTED_BY_SELF atau FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, konteks injeksi yang disediakan saat paket disuntikkan akan dikembalikan.

Nilai kembali

Fungsi FwpsQueryPacketInjectionState0 mengembalikan salah satu nilai konstanta enumerasi FWPS_PACKET_INJECTION_STATE .

Keterangan

Karena data paket yang disuntikkan dapat diklasifikasikan kembali terhadap callout yang menyuntikkannya, fungsi ini memungkinkan callout untuk memeriksa riwayat injeksi data paket bila perlu, sehingga menghindari kebutuhan untuk melakukan inspeksi data paket berulang yang telah diperiksa.

Callout dapat melacak informasi spesifik callout lainnya dengan menentukan handel injectionContext opsional di salah satu fungsi injeksi paket pada saat injeksi data paket. Jika fungsi FwpsQueryPacketInjectionState0 mengembalikan FWPS_PACKET_INJECTED_BY_SELF atau FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, injectionContext yang disediakan akan dikembalikan sebagai parameter completionContext dari fungsi yang melakukan injeksi.

Jika nilai yang dikembalikan FWPS_PACKET_INJECTED_BY_SELF atau FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, daftar buffer jaringan yang ditunjukkan oleh netBufferList tidak boleh dimodifikasi lebih lanjut atau ditunda sebagai bagian dari prosedur kloning dan injeksi. Dalam hal ini, callout harus mengatur anggota actionType dari struktur FWPS_CLASSIFY_OUT0 yang diacu oleh parameter classifyOut dari fungsi classifyFn ke FWP_ACTION_CONTINUE atau FWP_ACTION_PERMIT. Ini memungkinkan paket untuk melanjutkan ke callout berikutnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	fwpsk.h (termasuk Fwpsk.h)
Pustaka	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL