SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS código de control
La operación de control de E/S de socket SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS permite a un cliente winsock especificar el registro de redireccionamiento al nuevo socket TCP usado para conectarse al destino final.
Un registro de redireccionamiento de PMA es un búfer de datos opacos que EL PMA debe establecer en una conexión de proxy de salida para que la conexión redirigida y la conexión original estén relacionadas lógicamente.
Para obtener más información sobre el redireccionamiento, consulte Uso del redireccionamiento de enlace o conexión.
Para establecer el registro de redireccionamiento en el nuevo socket TCP usado para conectarse al destino final, un cliente winsock llama a la función WskControlSocket con los parámetros siguientes.
| Parámetro | Value |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS |
Level |
0 |
InputSize |
Tamaño del registro de redireccionamiento al que apunta el parámetro InputBuffer. |
InputBuffer |
Puntero al registro de redireccionamiento asociado al socket. |
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
Irp |
Puntero a un IRP. |
El cliente winsock debe asignar un búfer y especificar un puntero al búfer y su tamaño en InputBuffer y InputSize.
Un cliente winsock debe especificar un puntero a un IRP y una rutina de finalización al llamar a la función WskControlSocket para este tipo de solicitud. El cliente no debe liberar el búfer hasta que el subsistema WSK haya completado el IRP. Cuando completa el IRP, el subsistema invoca la rutina de finalización. En la rutina de finalización, el cliente debe comprobar el estado de IRP y liberar todos los recursos que había asignado previamente para la solicitud.
Nota También es posible realizar esta consulta en una aplicación en modo de usuario mediante SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK).
Para obtener más información sobre el control de IRP de WSK, consulte Uso de IRP con funciones del kernel de Winsock.
El cliente puede obtener el estado del IRP comprobando Irp-IoStatus.Status>. Irp-> IoStatus.Status se establecerá en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, contendrá STATUS_INTEGER_OVERFLOW o STATUS_ACCESS_DENIED si la llamada no se realiza correctamente.
Requisitos
Cliente mínimo compatible |
Windows 8 |
Servidor mínimo compatible |
Windows Server 2012 |
Encabezado |
Mstcpip.h |
IRQL |
PASSIVE_LEVEL |
Consulte también
Uso del redireccionamiento de enlace o conexión
Uso de IRP con funciones de kernel de Winsock