SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS 控制代码

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS套接字 I/O 控制操作允许 Winsock 客户端将重定向记录指定到用于连接到最终目标的新 TCP 套接字。

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

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

若要将重定向记录设置为用于连接到最终目标的新 TCP 套接字,Winsock 客户端使用以下参数调用 WskControlSocket 函数。

参数

RequestType

WskIoctl

ControlCode

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS

级别

0

InputSize

InputBuffer 参数指向的重定向记录的大小。

InputBuffer

指向与套接字关联的重定向记录的指针。

OutputSize

0

OutputBuffer

Null

OutputSizeReturned

Null

Irp

指向 IRP 的指针。

Winsock 客户端必须分配缓冲区,并在 InputBufferInputSize 中指定指向缓冲区的指针及其大小。

为此类请求调用 WskControlSocket 函数时,Winsock 客户端必须指定指向 IRP 的指针和完成例程。 在 WSK 子系统完成 IRP 之前,客户端不得释放缓冲区。 完成 IRP 后,子系统将调用完成例程。 在完成例程中,客户端必须检查 IRP 状态,并释放以前为请求分配的所有资源。

注意 还可以使用 SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK) 在用户模式应用程序中执行此查询。

有关 WSK IRP 处理的详细信息,请参阅 将 IRP 与 Winsock 内核函数配合使用

客户端可以通过检查 Irp-IoStatus.Status> 获取 IRP 的状态Irp->如果请求成功,IoStatus.Status 将设置为 STATUS_SUCCESS 。 否则,它将包含 STATUS_INTEGER_OVERFLOW,如果调用不成功,则 STATUS_ACCESS_DENIED

要求

最低受支持的客户端

Windows 8

最低受支持的服务器

Windows Server 2012

标头

Mstcpip.h

IRQL

PASSIVE_LEVEL

另请参阅

使用绑定或连接重定向

将 IRP 与 Winsock 内核函数配合使用

SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK)