SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS控制項程式碼

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS通訊端 I/O 控制作業可讓 Winsock 用戶端將重新導向記錄指定至用來連線到最終目的地的新 TCP 通訊端。

一個是一種不透明資料的緩衝區，在輸出 Proxy 連線上必須設定一個不透明資料，以便重新導向的連線和原始連接以邏輯方式相關。

如需重新導向的詳細資訊，請參閱 使用系結或連線重新導向。

若要將重新導向記錄設定為用來連線到最終目的地的新 TCP 通訊端，Winsock 用戶端會使用下列參數呼叫 WskControlSocket 函式。

參數	值
RequestType	WskIoctl
ControlCode	SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS
Level	0
InputSize	InputBuffer 參數所指向的重新導向記錄大小。
InputBuffer	與通訊端相關聯的重新導向記錄指標。
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL
Irp	IRP 的指標。

Winsock 用戶端必須配置緩衝區，並在InputBuffer和InputSize中指定緩衝區及其大小的指標。

Winsock 用戶端必須針對這種類型的要求呼叫 WskControlSocket 函式時，指定 IRP 的指標和完成常式。 在 WSK 子系統完成 IRP 之前，用戶端不得釋放緩衝區。 完成 IRP 時，子系統會叫用完成常式。 在完成常式中，用戶端必須檢查 IRP 狀態，並釋放先前為要求配置的所有資源。

注意 您也可以使用 SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK) ，在使用者模式應用程式中執行此查詢。

如需 WSK IRP 處理的詳細資訊，請參閱 搭配 Winsock 核心函式使用 IRP。

用戶端可以藉由檢查 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

另請參閱

使用系結或連線重新導向

搭配 Winsock 核心函式使用 IRP

SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK)