Compartilhar via


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

SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS

SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT (SDK)