código de controle SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS

  • Artigo

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

SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS

SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK)