estrutura FWPS_CONNECT_REQUEST0 (fwpsk.h)

Artigo
08/07/2023

A estrutura FWPS_CONNECT_REQUEST0 define dados modificáveis para as camadas FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V4 e FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V6 . O driver de texto explicativo usa esses dados para inspecionar ou modificar as informações de conexão.

ObserveFWPS_CONNECT_REQUEST0 é uma versão específica do FWPS_CONNECT_REQUEST. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

Sintaxe

typedef struct _FWPS_CONNECT_REQUEST0 {
  SOCKADDR_STORAGE              localAddressAndPort;
  SOCKADDR_STORAGE              remoteAddressAndPort;
  UINT64                        portReservationToken;
  DWORD                         localRedirectTargetPID;
  struct _FWPS_CONNECT_REQUEST0 *previousVersion;
  UINT64                        modifierFilterId;
  HANDLE                        localRedirectHandle;
  void                          *localRedirectContext;
  SIZE_T                        localRedirectContextSize;
} FWPS_CONNECT_REQUEST0;

Membros

localAddressAndPort

O endereço de transporte local da solicitação de conexão. Esse é um endereço IPV4 ou IPV6 e uma porta TCP formatada como uma estrutura SOCKADDR_STORAGE .

remoteAddressAndPort

O endereço de transporte remoto da solicitação de conexão. Esse é um endereço IPV4 ou IPV6 e uma porta TCP/UDP formatada como uma estrutura de SOCKADDR_STORAGE .

portReservationToken

Um token usado para reservar a porta apropriada. O token é obtido quando uma porta é reservada chamando CreatePersistentTcpPortReservation ou CreatePersistentUdpPortReservation.

localRedirectTargetPID

O identificador de processo do processo de host local que manipulará o tráfego para o endereço especificado em localAddressAndPort. Esse valor deve ser definido para que as alterações de redirecionamento de loopback sejam aceitas pelo mecanismo.

previousVersion

A versão anterior dos dados de solicitação de conexão. Esse campo somente leitura registra o histórico de modificação da solicitação de conexão. Se os dados de solicitação de conexão não tiverem sido modificados anteriormente por outro filtro WFP, previousVersion será definido como NULL.

modifierFilterId

O valor do membro FilterId do parâmetro de filtro da função classifyFn. Para obter mais informações sobre o membro FilterId , consulte FWPS_FILTER1.

localRedirectHandle

O identificador de redirecionamento que o driver de texto explicativo criou chamando a função FwpsRedirectHandleCreate0 .

Nota Começando com Windows 8, o localRedirectHandle deve ser preenchido para que o redirecionamento funcione.

localRedirectContext

Uma área de contexto do driver de texto explicativo que o driver de texto explicativo alocou chamando a função ExAllocatePoolWithTag .

Nota Começando com Windows 8, a memória alocada para localRedirectContext terá sua propriedade tomada pelo WFP e será liberada quando o fluxo com proxies for removido.

localRedirectContextSize

O tamanho, em bytes, da área de contexto fornecida pelo texto explicativo.

Nota Com suporte a partir do Windows 8.

Comentários

O driver de texto explicativo obtém essa estrutura chamando o Função FwpsAcquireWritableLayerDataPointer0 , que retorna um ponteiro para uma estrutura FWPS_CONNECT_REQUEST0 por meio do parâmetro writableLayerData . A função classifyFn pode modificar os parâmetros da solicitação de conexão, como redirecionar o endereço de transporte local ou remoto ou a porta para outro endereço ou porta. Se ele modificar os parâmetros da solicitação de conexão, a função classifyFn deverá fazer o seguinte:

Faça todas as alterações na estrutura FWPS_CONNECT_REQUEST0 que foi retornada por FwpsAcquireWritableLayerDataPointer0. Somente os membros remoteAddressAndPort, portReservationToken, localRedirectTargetPID, localRedirectHandle, localRedirectContext e localRedirectContextSize podem ser modificados.
Chamar FwpsApplyModifiedLayerData0 com o parâmetro modifiedLayerData definido como o endereço da estrutura FWPS_CONNECT_REQUEST0 , mesmo que o driver de texto explicativo não tenha modificado nenhum dado. Esse valor deve ser o mesmo que o valor do parâmetro modifiedLayerData retornado por meio de FwpsAcquireWritableLayerDataPointer0.

Essa estrutura atua como uma lista vinculada que contém um registro de todas as alterações feitas por outros drivers de texto explicativo. Há informações de versão anteriores se o membro previousVersion não for NULL. Para examinar o histórico de versão completo, o driver de texto explicativo deve continuar examinando o membro previousVersion de cada estrutura na lista até que ele seja definido como NULL.