codice di controllo SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS
L'operazione di controllo I/O del socket SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS consente a un client Winsock di specificare il record di reindirizzamento al nuovo socket TCP usato per la connessione alla destinazione finale.
Un record di reindirizzamento WFP è un buffer di dati opachi che il WFP deve impostare su una connessione proxy in uscita in modo che la connessione reindirizzata e la connessione originale siano logicamente correlate.
Per altre informazioni sul reindirizzamento, vedere Using Bind or Connect Redirection.For more information about redirection, see Using Bind or Connect Redirection.
Per impostare il record di reindirizzamento sul nuovo socket TCP usato per la connessione alla destinazione finale, un client Winsock chiama la funzione WskControlSocket con i parametri seguenti.
| Parametro | Valore |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS |
Level |
0 |
InputSize |
Dimensione del record di reindirizzamento a cui punta il parametro InputBuffer. |
Inputbuffer |
Puntatore al record di reindirizzamento associato al socket. |
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
Irp |
Puntatore a un IRP. |
Il client Winsock deve allocare un buffer e specificare un puntatore al buffer e le relative dimensioni in InputBuffer e InputSize.
Un client Winsock deve specificare un puntatore a un IRP e una routine di completamento quando si chiama la funzione WskControlSocket per questo tipo di richiesta. Il client non deve rilasciare il buffer finché il sottosistema WSK non ha completato l'IRP. Al termine dell'IRP, il sottosistema richiama la routine di completamento. Nella routine di completamento, il client deve controllare lo stato di IRP e rilasciare tutte le risorse allocate in precedenza per la richiesta.
Nota È anche possibile eseguire questa query in un'applicazione in modalità utente usando SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK).
Per altre informazioni sulla gestione di IRP WSK, vedere Using IRPs with Winsock Kernel Functions .For more information about WSK IRP handling, see Using IRPs with Winsock Kernel Functions.
Il client può ottenere lo stato dell'IRP controllando Irp-IoStatus.Status>. Irp-> IoStatus.Status verrà impostato su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, conterrà STATUS_INTEGER_OVERFLOW o STATUS_ACCESS_DENIED se la chiamata non riesce.
Requisiti
Client minimo supportato |
Windows 8 |
Server minimo supportato |
Windows Server 2012 |
Intestazione |
Mstcpip.h |
IRQL |
PASSIVE_LEVEL |
Vedi anche
Uso di Bind o Connect Redirection
Uso dei runtime di integrazione con funzioni kernel Winsock