estrutura FWPS_BIND_REQUEST0 (fwpsk.h)

Artigo
08/07/2023

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

ObserveFWPS_BIND_REQUEST0 é uma versão específica do FWPS_BIND_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_BIND_REQUEST0 {
  SOCKADDR_STORAGE           localAddressAndPort;
  UINT64                     portReservationToken;
  struct _FWPS_BIND_REQUEST0 *previousVersion;
  UINT64                     modifierFilterId;
} FWPS_BIND_REQUEST0;

Membros

localAddressAndPort

O endereço de transporte local da solicitação de associaçã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. Ambas as funções de reserva podem ser encontradas em iphlpapi.h.

previousVersion

A versão anterior dos dados da solicitação de associação. Esse campo somente leitura registra o histórico de modificação da solicitação de associação. Esse membro é pré-inicializado com um ponteiro para uma lista vinculada com o índice definido como o registro para os dados FWPS_BIND_REQUEST0 atuais.

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.

Comentários

O driver de texto explicativo obtém essa estrutura chamando o Função FwpsAcquireWritableLayerDataPointer0 , que retorna um ponteiro para uma estrutura FWPS_BIND_REQUEST0 por meio do parâmetro writableLayerData .

A função classifyFn pode modificar os parâmetros da solicitação de associação, como redirecionar o endereço de transporte local ou a porta para outro endereço ou porta. Se ele modificar os parâmetros da solicitação de associação, o
A função classifyFn deve fazer o seguinte:

Faça todas as alterações na estrutura FWPS_BIND_REQUEST0 que foi retornada por FwpsAcquireWritableLayerDataPointer0. Somente os membros localAddressAndPort e portReservationToken podem ser modificados.
Chamar FwpsApplyModifiedLayerData0 com o parâmetro modifiedLayerData definido como o endereço da estrutura FWPS_BIND_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 que foi retornado por 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é encontrar um nó que tenha esse membro definido como um valor NULL.