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