struktur FWPS_CONNECT_REQUEST0 (fwpsk.h)

Artikel
02/26/2024

Struktur FWPS_CONNECT_REQUEST0 mendefinisikan data yang dapat dimodifikasi untuk lapisan FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V4 dan FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V6 . Driver callout menggunakan data ini untuk memeriksa atau mengubah informasi koneksi.

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

Sintaks

typedef struct _FWPS_CONNECT_REQUEST0 {
  SOCKADDR_STORAGE              localAddressAndPort;
  SOCKADDR_STORAGE              remoteAddressAndPort;
  UINT64                        portReservationToken;
  DWORD                         localRedirectTargetPID;
  struct _FWPS_CONNECT_REQUEST0 *previousVersion;
  UINT64                        modifierFilterId;
  HANDLE                        localRedirectHandle;
  void                          *localRedirectContext;
  SIZE_T                        localRedirectContextSize;
} FWPS_CONNECT_REQUEST0;

Anggota

localAddressAndPort

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

remoteAddressAndPort

Alamat transportasi jarak jauh dari permintaan sambungkan. 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.

localRedirectTargetPID

Pengidentifikasi proses proses host lokal yang akan menangani lalu lintas ke alamat yang ditentukan dalam localAddressAndPort. Nilai ini harus diatur agar perubahan pengalihan loopback diterima oleh mesin.

previousVersion

Versi sebelumnya dari data permintaan sambungkan. Bidang baca-saja ini merekam riwayat modifikasi permintaan sambungkan. Jika data permintaan sambungkan belum dimodifikasi sebelumnya oleh filter WFP lain, previousVersion akan diatur ke NULL.

modifierFilterId

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

localRedirectHandle

Handel pengalihan yang dibuat driver callout dengan memanggil fungsi FwpsRedirectHandleCreate0 .

Catatan Dimulai dengan Windows 8, localRedirectHandle harus diisi agar pengalihan berfungsi.

localRedirectContext

Area konteks driver callout yang dialokasikan driver callout dengan memanggil fungsi ExAllocatePoolWithTag .

Catatan Dimulai dengan Windows 8, memori yang dialokasikan untuk localRedirectContext akan memiliki kepemilikannya yang diambil oleh WFP, dan akan dibebaskan ketika alur yang diproksi dihapus.

localRedirectContextSize

Ukuran, dalam byte, dari area konteks yang disediakan callout.

Catatan Didukung dimulai dengan Windows 8.

Keterangan

Driver callout memperoleh struktur ini dengan memanggil Fungsi FwpsAcquireWritableLayerDataPointer0 , yang mengembalikan pointer ke struktur FWPS_CONNECT_REQUEST0 melalui parameter writableLayerData . Fungsi classifyFn dapat memodifikasi parameter permintaan sambungkan, seperti mengalihkan alamat transportasi lokal atau jarak jauh atau port ke alamat atau port lain. Jika memodifikasi parameter permintaan koneksi, fungsi classifyFn harus melakukan hal berikut:

Buat semua perubahan pada struktur FWPS_CONNECT_REQUEST0 yang dikembalikan oleh FwpsAcquireWritableLayerDataPointer0. Hanya remoteAddressAndPort, portReservationToken, localRedirectTargetPID, localRedirectHandle, localRedirectContext, dan localRedirectContextSize yang dapat dimodifikasi.
Call FwpsApplyModifiedLayerData0 dengan parameter modifiedLayerData diatur ke alamat struktur FWPS_CONNECT_REQUEST0 , bahkan jika driver callout tidak mengubah data apa pun. Nilai ini harus sama dengan nilai parameter modifiedLayerData yang dikembalikan melalui 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 hingga diatur ke NULL.