SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS-Steuerungscode

Der SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS Socket-E/A-Steuerungsvorgang ermöglicht es einem Winsock-Client, den Umleitungsdatensatz an den neuen TCP-Socket anzugeben, der für die Verbindung mit dem endgültigen Ziel verwendet wird.

Ein WFP-Umleitungsdatensatz ist ein Puffer von undurchsichtigen Daten, den WFP für eine ausgehende Proxyverbindung festlegen muss, damit die umgeleitete Verbindung und die ursprüngliche Verbindung logisch miteinander verknüpft sind.

Weitere Informationen zur Umleitung finden Sie unter Using Bind or Connect Redirection.For more information about redirection, see Using Bind or Connect Redirection.

Um den Umleitungsdatensatz auf den neuen TCP-Socket festzulegen, der zum Herstellen einer Verbindung mit dem endgültigen Ziel verwendet wird, ruft ein Winsock-Client die WskControlSocket-Funktion mit den folgenden Parametern auf.

Parameter	Wert
Requesttype	WskIoctl
ControlCode	SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS
Level	0
InputSize	Die Größe des Umleitungsdatensatzes, auf den der InputBuffer-Parameter verweist.
Inputbuffer	Ein Zeiger auf den Umleitungsdatensatz, der dem Socket zugeordnet ist.
OutputSize	0
OutputBuffer	NULL
OutputSizeReturned	NULL
Irp	Ein Zeiger auf eine IRP.

Der Winsock-Client muss einen Puffer zuordnen und einen Zeiger auf den Puffer und dessen Größe in InputBuffer und InputSize angeben.

Ein Winsock-Client muss einen Zeiger auf ein IRP und eine Vervollständigungsroutine angeben, wenn die WskControlSocket-Funktion für diesen Anforderungstyp aufgerufen wird. Der Client darf den Puffer erst freigeben, wenn das WSK-Subsystem die IRP abgeschlossen hat. Wenn das IRP abgeschlossen ist, ruft das Subsystem die Vervollständigungsroutine auf. In der Vervollständigungsroutine muss der Client die IRP-status überprüfen und alle Ressourcen freigeben, die er zuvor für die Anforderung zugewiesen hatte.

Hinweis Es ist auch möglich, diese Abfrage in einer Anwendung im Benutzermodus mithilfe von SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK) auszuführen.

Weitere Informationen zur WSK-IRP-Behandlung finden Sie unter Verwenden von IRPs mit Winsock-Kernelfunktionen.

Der Client kann die status des IRP abrufen, indem er Irp-IoStatus.Status> überprüft. Irp-> IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls enthält sie STATUS_INTEGER_OVERFLOW oder STATUS_ACCESS_DENIED , wenn der Aufruf nicht erfolgreich ist.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Header	Mstcpip.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

Verwenden von Binden oder Verbinden der Umleitung

Verwenden von IRPs mit Winsock-Kernelfunktionen

SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK)