FwpsQueryConnectionSioFormatRedirectRecords0 函数 (fwpsk.h)

项目
02/29/2024

FwpsQueryConnectionSioFormatRedirectRecords0 函数返回重定向连接的连接重定向记录。有关重定向的详细信息，请参阅使用绑定或连接重定向。

注意FwpsQueryConnectionSioFormatRedirectRecords0 是 FwpsQueryConnectionSioFormatRedirectRecords 的特定版本。有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows 。

语法

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

参数

[in] RedirectRecords

重定向记录ALE_CONNECT_REDIRECT标注函数在其 classifyFn 函数的 inMetaValues 参数中接收的句柄。可以在 FWPS_INCOMING_METADATA_VALUES0 结构的 redirectRecords 成员中找到此句柄。

WFP 重定向记录是一个不透明数据的缓冲区，WFP 必须在出站代理连接上设置该缓冲区，以便重定向的连接与原始连接在逻辑上相关。

[out, optional] OutputBuffer

指向接收重定向记录的输出缓冲区的指针。缓冲区必须与指针对齐。

[in] OutputBufferLength

输出缓冲区的大小（以字节为单位）。

[out, optional] BytesTransferred

指向接收已传输字节数的变量的指针。如果返回值 STATUS_BUFFER_TOO_SMALL，则此参数接收所需的缓冲区大小。

返回值

返回一个 NTSTATUS 值，如下所示。

返回代码	说明
STATUS_BUFFER_TOO_SMALL	输出缓冲区太小，无法包含要传输的所有字节。数据传输失败，可在 BytesTransferred 参数中找到所需的缓冲区大小。
STATUS_NOT_FOUND	RedirectRecords 参数为 null。

注解

FwpsQueryConnectionSioFormatRedirectRecords0 函数仅适用于本地代理。

有关重定向的详细信息，请参阅使用绑定或连接重定向。

FwpsQueryConnectionSioFormatRedirectRecords0 函数旨在供 WFP 连接重定向标注驱动程序使用，该驱动程序在验证能够连接到实际远程终结点之前不接受重定向的连接。为此，标注驱动程序在 FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 或 FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 层上放置重定向的连接请求，并调用 FwpsQueryConnectionSioFormatRedirectRecords0 来检索连接重定向记录，标注驱动程序随后会将该记录发送到代理以用于调用SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS。

要求

要求	值
最低受支持的客户端	Windows 7
最低受支持的服务器	Windows Server 2008 R2
目标平台	通用
标头	fwpsk.h (包括 Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL