Fungsi FwpsRedirectHandleCreate0 (fwpsk.h)

Artikel
08/07/2023

Fungsi FwpsRedirectHandleCreate0 membuat handel yang dapat digunakan fungsi pengalihan koneksi untuk mengalihkan koneksi ke proses lokal. Untuk informasi selengkapnya tentang pengalihan, lihat Menggunakan Ikatan atau Sambungkan Pengalihan.

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

Sintaks

NTSTATUS FwpsRedirectHandleCreate0(
  const GUID *providerGuid,
  UINT32     flags,
  HANDLE     *redirectHandle
);

Parameter

providerGuid

GUID penyedia.

flags

Dicadangkan. Atur ke nol.

redirectHandle

Penunjuk ke variabel yang menerima handel.

Mengembalikan nilai

Fungsi FwpsRedirectHandleCreate0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Handel pengalihan berhasil dikembalikan. Variabel yang ditujukan parameter redirectHandle berisi handel.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout memanggil fungsi FwpsRedirectHandleCreate0 untuk membuat handel yang dapat digunakan untuk mengalihkan koneksi.

Untuk informasi selengkapnya tentang pengalihan, lihat Menggunakan Ikatan atau Sambungkan Pengalihan.

Driver callout Anda harus memanggil FwpsRedirectHandleCreate0 sekali dan menyimpan cache handel sehingga dapat menggunakan kembali handel.

Sebelum callout pengalihan koneksi Application Layer Enforcement (ALE) dapat mengalihkan koneksi ke proses lokal, ia harus mendapatkan handel pengalihan dengan fungsi FwpsRedirectHandleCreate0 dan meletakkan handel dalam struktur FWPS_CONNECT_REQUEST0 . Callout memodifikasi struktur di classifyFn untuk lapisan pengalihan koneksi ALE.

Setelah driver callout selesai menggunakan handel pengalihan, driver tersebut harus memanggil fungsi FwpsRedirectHandleDestroy0 untuk menghancurkan handel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Universal
Header	fwpsk.h (termasuk Fwpsk.h)
Pustaka	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Lihat juga

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classifyFn

Share via