SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS código de controle

A operação de controle de E/S do soquete SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS permite que um cliente Winsock recupere o registro de redirecionamento para uma conexão redirecionada.

Um registro de redirecionamento do 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 o redirecionamento, consulte Usando Associação ou Redirecionamento de Conexão.

Para consultar o registro de redirecionamento para a conexão redirecionada, 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_RECORDS
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 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 de aproximadamente 1 KB de tamanho. Se o tamanho do buffer de saída não for grande o suficiente, WskControlSocket retornará um STATUS_BUFFER_TOO_SMALL e OutputSizeReturned conterá o tamanho necessário do buffer. Em seguida, um buffer maior pode ser alocado e WskControlSocket chamado novamente com a solicitação SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS 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_RECORDS e OutputBuffer definidos como o buffer.

Nota Também é possível executar essa consulta em um aplicativo de modo de usuário usando SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS (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 do WSK conclui o IRP, ele notifica o cliente invocando a rotina de conclusão. Uma referência a esse buffer é passada ao 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
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

SIO_QUERY_WFP_CONNECTION_REDIRECT_CONTEXT

SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS (SDK)

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS