struktur FWPS_BIND_REQUEST0 (fwpsk.h)

Artikel
08/07/2023

Struktur FWPS_BIND_REQUEST0 menentukan data yang dapat dimodifikasi untuk lapisan FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 dan FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6. Driver callout menggunakan data ini untuk memeriksa atau mengubah informasi koneksi.

CatatanFWPS_BIND_REQUEST0 adalah versi FWPS_BIND_REQUEST tertentu. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

typedef struct _FWPS_BIND_REQUEST0 {
  SOCKADDR_STORAGE           localAddressAndPort;
  UINT64                     portReservationToken;
  struct _FWPS_BIND_REQUEST0 *previousVersion;
  UINT64                     modifierFilterId;
} FWPS_BIND_REQUEST0;

Anggota

localAddressAndPort

Alamat transportasi lokal permintaan ikatan. Ini adalah alamat IPV4 atau IPV6 dan port TCP/UDP yang diformat sebagai struktur SOCKADDR_STORAGE .

portReservationToken

Token yang digunakan untuk memesan port yang sesuai. Token diperoleh ketika port dicadangkan dengan memanggil CreatePersistentTcpPortReservation atau CreatePersistentUdpPortReservation. Kedua fungsi reservasi dapat ditemukan di iphlpapi.h.

previousVersion

Versi sebelumnya dari data permintaan ikatan. Bidang baca-saja ini merekam riwayat modifikasi permintaan ikatan. Anggota ini diinisialisasi sebelumnya dengan penunjuk ke daftar yang ditautkan dengan indeks yang diatur ke rekaman untuk data FWPS_BIND_REQUEST0 saat ini.

modifierFilterId

Nilai anggota FilterId dari parameter filter fungsi classifyFn. Untuk informasi selengkapnya tentang anggota FilterId , lihat FWPS_FILTER1.

Keterangan

Driver callout memperoleh struktur ini dengan memanggil Fungsi FwpsAcquireWritableLayerDataPointer0 , yang mengembalikan penunjuk ke struktur FWPS_BIND_REQUEST0 melalui parameter writableLayerData .

Fungsi classifyFn dapat memodifikasi parameter permintaan ikatan, seperti mengalihkan alamat transportasi lokal atau port ke alamat atau port lain. Jika memodifikasi parameter permintaan ikatan,
fungsi classifyFn harus melakukan hal berikut:

Buat semua perubahan pada struktur FWPS_BIND_REQUEST0 yang dikembalikan oleh FwpsAcquireWritableLayerDataPointer0. Hanya anggota localAddressAndPort dan portReservationToken yang dapat dimodifikasi.
Call FwpsApplyModifiedLayerData0 dengan parameter modifiedLayerData diatur ke alamat struktur FWPS_BIND_REQUEST0 , bahkan jika driver callout tidak memodifikasi data apa pun. Nilai ini harus sama dengan nilai parameter modifiedLayerData yang dikembalikan oleh FwpsAcquireWritableLayerDataPointer0.

Struktur ini bertindak sebagai daftar tertaut yang berisi catatan semua perubahan yang dibuat oleh driver callout lainnya. Ada informasi versi sebelumnya jika anggota previousVersion bukan NULL. Untuk memeriksa riwayat versi lengkap, driver callout harus terus memeriksa anggota previousVersion dari setiap struktur dalam daftar sampai menemukan simpul yang anggota ini diatur ke nilai NULL.