Fungsi FwpsQueryConnectionSioFormatRedirectRecords0 (fwpsk.h)

Artikel
03/01/2024

Fungsi FwpsQueryConnectionSioFormatRedirectRecords0 mengembalikan rekaman pengalihan koneksi untuk koneksi yang dialihkan. Untuk informasi selengkapnya tentang pengalihan, lihat Menggunakan Ikatan atau Sambungkan Pengalihan.

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

Sintaks

NTSTATUS FwpsQueryConnectionSioFormatRedirectRecords0(
  [in]            HANDLE  RedirectRecords,
  [out, optional] PVOID   OutputBuffer,
  [in]            SIZE_T  OutputBufferLength,
  [out, optional] PSIZE_T BytesTransferred
);

Parameter

[in] RedirectRecords

Rekaman pengalihan menangani bahwa fungsi callout ALE_CONNECT_REDIRECT diterima dalam parameter inMetaValues dari fungsi classifyFn-nya . Handel ini dapat ditemukan di anggota redirectRecords dari struktur FWPS_INCOMING_METADATA_VALUES0 .

Catatan pengalihan WFP adalah buffer data buram yang harus diatur WFP pada koneksi proksi keluar sehingga koneksi yang dialihkan dan koneksi asli terkait secara logis.

[out, optional] OutputBuffer

Penunjuk ke buffer output yang menerima rekaman pengalihan. Buffer harus diratakan pointer.

[in] OutputBufferLength

Ukuran, dalam byte, dari buffer output.

[out, optional] BytesTransferred

Penunjuk ke variabel yang menerima jumlah byte yang ditransfer. Jika nilai yang dikembalikan STATUS_BUFFER_TOO_SMALL, parameter ini menerima ukuran buffer yang diperlukan.

Mengembalikan nilai

Mengembalikan nilai NTSTATUS seperti salah satu hal berikut ini.

Menampilkan kode	Deskripsi
STATUS_BUFFER_TOO_SMALL	Buffer output terlalu kecil untuk berisi semua byte yang akan ditransfer. Transfer data gagal, dan ukuran buffer yang diperlukan dapat ditemukan di parameter BytesTransferred .
STATUS_NOT_FOUND	Parameter RedirectRecords null.

Keterangan

Fungsi FwpsQueryConnectionSioFormatRedirectRecords0 hanya berlaku untuk proksi lokal.

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

Fungsi FwpsQueryConnectionSioFormatRedirectRecords0 dirancang untuk digunakan oleh driver callout pengalihan koneksi WFP yang tidak menerima koneksi yang dialihkan sampai telah memverifikasi bahwa ia dapat terhubung ke titik akhir jarak jauh yang sebenarnya. Untuk melakukan ini, driver callout menunggu permintaan koneksi yang dialihkan pada lapisan FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 atau FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 dan memanggil FwpsQueryConnectionSioFormatRedirectRecords0 untuk mengambil rekaman pengalihan koneksi, yang kemudian dikirim driver callout ke proksi untuk digunakan dalam panggilan ke SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Universal
Header	fwpsk.h (termasuk Fwpsk.h)
Pustaka	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL