SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS 套接字 I/O 控制作允许 Winsock 客户端将重定向记录指定到用于连接到最终目标的新 TCP 套接字。
WFP 重定向记录是在出站代理连接上必须设置的不透明数据的缓冲区，以便重定向的连接和原始连接在逻辑上相关。
有关重定向的详细信息，请参阅 使用绑定或连接重定向。
若要将重定向记录设置为用于连接到最终目标的新 TCP 套接字，Winsock 客户端使用以下参数调用 WskControlSocket 函数。
| 参数 | 价值 |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS |
级别 |
0 |
InputSize |
InputBuffer 参数指向的重定向记录的大小。 |
InputBuffer |
指向与套接字关联的重定向记录的指针。 |
OutputSize |
0 |
OutputBuffer |
零 |
OutputSizeReturned |
零 |
Irp |
指向 IRP 的指针。 |
Winsock 客户端必须分配缓冲区，并指定指向缓冲区及其大小的指针，InputBuffer 和 InputSize。
Winsock 客户端必须在为此类请求调用 WskControlSocket 函数时指定指向 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 |