código de controle SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS
A operação de controle de E/S do soquete SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS permite que um cliente Winsock especifique o registro de redirecionamento para o novo soquete TCP usado para se conectar ao destino final.
Um registro de redirecionamento WFP é um buffer de dados opacos que o WFP deve definir em uma conexão de proxy de saída para que a conexão redirecionada e a conexão original estejam logicamente relacionadas.
Para obter mais informações sobre redirecionamento, consulte Usando Associação ou Redirecionamento de Conexão.
Para definir o registro de redirecionamento para o novo soquete TCP usado para se conectar ao destino final, um cliente Winsock chama a função WskControlSocket com os parâmetros a seguir.
| Parâmetro | Valor |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS |
Level |
0 |
InputSize |
O tamanho do registro de redirecionamento apontado pelo parâmetro InputBuffer. |
Inputbuffer |
Um ponteiro para o registro de redirecionamento associado ao soquete. |
OutputSize |
0 |
OutputBuffer |
NULO |
OutputSizeReturned |
NULO |
Irp |
Um ponteiro para um IRP. |
O cliente Winsock deve alocar um buffer e especificar um ponteiro para o buffer e seu tamanho em InputBuffer e InputSize.
Um cliente Winsock deve especificar um ponteiro para um IRP e uma rotina de conclusão ao chamar a função WskControlSocket para esse tipo de solicitação. O cliente não deve liberar o buffer até que o subsistema WSK tenha concluído o IRP. Quando ele conclui o IRP, o subsistema invoca a rotina de conclusão. Na rotina de conclusão, o cliente deve marcar o status IRP e liberar todos os recursos alocados anteriormente para a solicitação.
Nota Também é possível executar essa consulta em um aplicativo no modo de usuário usando SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK).
Para obter mais informações sobre o tratamento de IRP do WSK, consulte Usando IRPs com funções de kernel winsock.
O cliente pode obter o status do IRP verificando Irp-IoStatus.Status>. Irp-> IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, ele conterá STATUS_INTEGER_OVERFLOW ou STATUS_ACCESS_DENIED se a chamada não for bem-sucedida.
Requisitos
Cliente mínimo com suporte |
Windows 8 |
Servidor mínimo com suporte |
Windows Server 2012 |
Cabeçalho |
Mstcpip.h |
IRQL |
PASSIVE_LEVEL |
Confira também
Usando o redirecionamento de associação ou conexão
Usando IRPs com funções de kernel Winsock