código de controle SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT
A operação de controle de E/S do soquete SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT permite que um cliente Winsock recupere o contexto de redirecionamento para um registro de redirecionamento para uma conexão redirecionada.
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.
Nota A consulta SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS só poderá ser usada se a conexão tiver sido redirecionada na camada FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 ou FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 por um cliente WFP.
Para obter mais informações sobre redirecionamento, consulte Usando Associação ou Redirecionamento de Conexão.
Para consultar o contexto de redirecionamento de um registro de redirecionamento, um cliente Winsock chama a função WskControlSocket com os parâmetros a seguir.
| Parâmetro | Valor |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT |
Level |
0 |
InputSize |
0 |
Inputbuffer |
NULO |
OutputSize |
O tamanho, em bytes, do buffer apontado pelo parâmetro OutputBuffer . |
OutputBuffer |
Um ponteiro para o buffer que recebe o contexto de redirecionamento para o registro de redirecionamento para a conexão TCP aceita. O tamanho do buffer é especificado no parâmetro OutputSize . |
OutputSizeReturned |
Um ponteiro para uma variável do tipo ULONG que recebe o número de bytes de dados copiados para o buffer apontado pelo parâmetro OutputBuffer . |
Irp |
Um ponteiro para um IRP. |
O chamador pode executar essa consulta de qualquer uma das seguintes maneiras:
- Ele pode definir o OutputBuffer como um buffer grande com aproximadamente 1 KB de tamanho. Se o tamanho do buffer de saída não for grande o suficiente, WskControlSocket retornará STATUS_BUFFER_TOO_SMALL e OutputSizeReturned conterá o tamanho necessário do buffer. Um buffer maior pode ser alocado e WskControlSocket chamado novamente com a solicitação SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT e OutputBuffer definidos como o buffer maior.
- Ou pode definir o parâmetro OutputSize como 0 e OutputBuffer como NULL e, em seguida, chamar WskControlSocket. Após a conclusão, a função WskControlSocket recupera o tamanho do buffer de saída, em bytes, no parâmetro OutputSizeReturned . Um buffer de tamanho apropriado pode ser alocado e WskControlSocket chamado novamente com a solicitação SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT e OutputBuffer definidos como o buffer.
Nota Também é possível executar essa consulta em um aplicativo no modo de usuário usando SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT (SDK).
Para esse tipo de solicitação, o cliente Winsock deve especificar um ponteiro para um IRP e um ponteiro para sua rotina de conclusão. O IRP pode ser passado para o cliente por um driver superior ou o cliente pode optar por alocar o IRP. Para especificar a rotina de conclusão, o cliente deve chamar IoSetCompletionRoutine. Para obter mais detalhes, consulte Usando IRPs com funções de kernel Winsock.
O cliente Winsock não deve liberar o buffer alocado até que o IRP seja concluído pelo subsistema WSK. Quando o subsistema WSK conclui o IRP, ele notifica o cliente invocando a rotina de conclusão. Uma referência a esse buffer é passada para o cliente pelo subsistema WSK no parâmetro Context da rotina de conclusão. O tamanho do buffer é armazenado em Irp-IoStatus.Information>.
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, STATUS_NOT_FOUND, STATUS_BUFFER_TOO_SMALL 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 |
parâmetro |
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