estrutura FWPS_INCOMING_METADATA_VALUES0 (fwpsu.h)

Artigo
06/12/2024

Define valores de metadados que o mecanismo de filtro passa para a função de texto explicativo classifyFn de um texto explicativo.

Observação

FWPS_INCOMING_METADATA_VALUES0 é uma versão específica do FWPS_INCOMING_METADATA_VALUES. Para obter mais informações, consulte Nomes independentes de versão do WFP e direcionamento para versões específicas do Windows.

Sintaxe

typedef struct FWPS_INCOMING_METADATA_VALUES0_ {
  UINT32                          currentMetadataValues;
  UINT32                          flags;
  UINT64                          reserved;
  FWPS_DISCARD_METADATA0          discardMetadata;
  UINT64                          flowHandle;
  UINT32                          ipHeaderSize;
  UINT32                          transportHeaderSize;
  FWP_BYTE_BLOB                   *processPath;
  UINT64                          token;
  UINT64                          processId;
  UINT32                          sourceInterfaceIndex;
  UINT32                          destinationInterfaceIndex;
  ULONG                           compartmentId;
  FWPS_INBOUND_FRAGMENT_METADATA0 fragmentMetadata;
  ULONG                           pathMtu;
  HANDLE                          completionHandle;
  UINT64                          transportEndpointHandle;
  SCOPE_ID                        remoteScopeId;
  WSACMSGHDR                      *controlData;
  ULONG                           controlDataLength;
  FWP_DIRECTION                   packetDirection;
  PVOID                           headerIncludeHeader;
  ULONG                           headerIncludeHeaderLength;
  IP_ADDRESS_PREFIX               destinationPrefix;
  UINT16                          frameLength;
  UINT64                          parentEndpointHandle;
  UINT32                          icmpIdAndSequence;
  DWORD                           localRedirectTargetPID;
  SOCKADDR                        *originalDestination;
  HANDLE                          redirectRecords;
  UINT32                          currentL2MetadataValues;
  UINT32                          l2Flags;
  UINT32                          ethernetMacHeaderSize;
  UINT32                          wiFiOperationMode;
  HANDLE                          vSwitchPacketContext;
  PVOID                           subProcessTag;
  UINT64                          reserved1;
} FWPS_INCOMING_METADATA_VALUES0;

Membros

currentMetadataValues

Um valor UINT32 que contém um OR bit a bit de uma combinação de identificadores de campo de metadados que especificam quais valores de metadados são definidos na estrutura.

flags

Usado internamente pelo mecanismo de filtro. Os drivers de texto explicativo devem ignorar esse membro.

reserved

Reservado para uso do sistema. Os drivers de texto explicativo devem ignorar esse membro.

discardMetadata

Uma estrutura FWPS_DISCARD_METADATA0 que descreve o motivo pelo qual os dados foram descartados. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_DISCARD_REASON estiver definido no membro currentMetadataValues .

flowHandle

Um identificador para o fluxo de dados. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_FLOW_HANDLE estiver definido no membro currentMetadataValues .

ipHeaderSize

O deslocamento, em bytes, do cabeçalho IP.

Em caminhos de entrada, ipHeaderSize, quando usado em conjunto com o membro transportHeaderSize , especifica o número de bytes a serem retirados do local de deslocamento de dados para o início do cabeçalho IP.

Nas seguintes camadas de erro ICMP de entrada, ipHeaderSize sozinho especifica o número total de bytes a serem retirados do deslocamento de dados para o início do cabeçalho IP:

FWPS_LAYER_INBOUND_ICMP_ERROR_V4

FWPS_LAYER_INBOUND_ICMP_ERROR_V6

FWPS_LAYER_INBOUND_ICMP_ERROR_V4_DISCARD

FWPS_LAYER_INBOUND_ICMP_ERROR_V6_DISCARD

Em caminhos de saída, se ipHeaderSize for maior que zero, ele especificará o número de bytes para avançar do local de deslocamento de dados para o final do cabeçalho IP.

Esse membro não é aplicável ao caminho de saída nas seguintes camadas:

FWPS_LAYER_DATAGRAM_DATA_V4

FWPS_LAYER_DATAGRAM_DATA_V6

FWPS_LAYER_DATAGRAM_DATA_V4_DISCARD

FWPS_LAYER_DATAGRAM_DATA_V6_DISCARD

Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_IP_HEADER_SIZE estiver definido no membro currentMetadataValues .

transportHeaderSize

O deslocamento ou tamanho, em bytes, do cabeçalho de transporte.

Em caminhos de entrada, transportHeaderSize especifica o número de bytes a serem retirados do local de deslocamento de dados para o final do cabeçalho de transporte.

Nas seguintes camadas de erro ICMP de entrada, transportHeaderSize especifica o tamanho do cabeçalho ICMP:

FWPS_LAYER_INBOUND_ICMP_ERROR_V4

FWPS_LAYER_INBOUND_ICMP_ERROR_V6

FWPS_LAYER_INBOUND_ICMP_ERROR_V4_DISCARD

FWPS_LAYER_INBOUND_ICMP_ERROR_V6_DISCARD

Em caminhos de saída, transportHeaderSize especifica o número de bytes para avançar do local de deslocamento de dados para o final do cabeçalho de transporte.

Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_TRANSPORT_HEADER_SIZE estiver definido no membro currentMetadataValues .

processPath

Um ponteiro para uma estrutura FWP_BYTE_BLOB que contém o caminho completo para o processo que possui o ponto de extremidade. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_PROCESS_PATH estiver definido no membro currentMetadataValues .

token

Um identificador para o token usado para validar as permissões para o usuário. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_TOKEN estiver definido no membro currentMetadataValues .

processId

A ID do processo que possui o ponto de extremidade. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_PROCESS_ID estiver definido no membro currentMetadataValues .

sourceInterfaceIndex

O índice do adaptador de rede em que um pacote de entrada foi recebido. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_SOURCE_INTERFACE_INDEX estiver definido no membro currentMetadataValues .

destinationInterfaceIndex

O índice do adaptador de rede para o qual um pacote de saída deve ser enviado. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_DESTINATION_INTERFACE_INDEX estiver definido no membro currentMetadataValues .

compartmentId

O identificador do compartimento de roteamento no qual o pacote foi recebido ou está sendo enviado. Todos os pacotes modificados devem ser injetados de volta no mesmo compartimento de roteamento indicado para o pacote original. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_COMPARTMENT_ID estiver definido no membro currentMetadataValues .

fragmentMetadata

Uma estrutura FWPS_INBOUND_FRAGMENT_METADATA0 que descreve os dados de fragmento de um fragmento de pacote recebido. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_FRAGMENT_DATA estiver definido no membro currentMetadataValues .

pathMtu

A MTU (unidade de transmissão máxima) do caminho para um pacote de saída. Esse valor indica o maior tamanho de pacote físico, em bytes, que uma rede pode transmitir sem fragmentação. Esse membro contém dados válidos somente se o sinalizador FWPS_METADATA_FIELD_PATH_MTU estiver definido no membro currentMetadataValues .

completionHandle

Um identificador de conclusão necessário para aguardar a operação de filtragem atual. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_COMPLETION_HANDLE estiver definido no membro currentMetadataValues .

transportEndpointHandle

Um identificador de ponto de extremidade que indica o final do pacote a ser injetado na camada de transporte de saída. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_TRANSPORT_ENDPOINT_HANDLE estiver definido no membro currentMetadataValues .

remoteScopeId

O identificador de escopo remoto a ser usado na injeção de camada de transporte de saída. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_REMOTE_SCOPE_ID estiver definido no membro currentMetadataValues .

controlData

Um objeto de dados de controle de soquete opcional. Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_TRANSPORT_CONTROL_DATA estiver definido no membro currentMetadataValues . Para obter informações sobre o tipo WSACMSGHDR , consulte CMSGHDR.

controlDataLength

O comprimento, em bytes, do membro controlData .

packetDirection

A direção do tráfego de rede (entrada ou saída), conforme especificado por um dos valores constantes de FWP_DIRECTION. Esse membro é definido na aplicação da camada de aplicativo (ALE) conectar ou receber/aceitar camadas durante uma operação de classificação de reautorização. Para obter mais informações, consulte a seção Comentários.

Esse membro conterá dados válidos somente se o sinalizador FWPS_METADATA_FIELD_PACKET_DIRECTION estiver definido no membro currentMetadataValues .

headerIncludeHeader

Um ponteiro para o cabeçalho IP se o pacote for enviado de um soquete bruto.

Disponível somente no Windows Server 2008, Windows Vista SP1 e versões posteriores do Windows.

headerIncludeHeaderLength

O comprimento, em bytes, do cabeçalho IP apontado por headerIncludeHeader.

Disponível somente no Windows Server 2008, Windows Vista SP1 e versões posteriores do Windows.

destinationPrefix

O prefixo de destino.