estrutura FWPS_FILTER0 (fwpstypes.h)
A estrutura FWPS_FILTER0 define um filtro de tempo de execução no mecanismo de filtro. FWPS_FILTER2 está disponível. Para o Windows 7, FWPS_FILTER1 está disponível.
Sintaxe
typedef struct FWPS_FILTER0_ {
UINT64 filterId;
FWP_VALUE0 weight;
UINT16 subLayerWeight;
UINT16 flags;
UINT32 numFilterConditions;
FWPS_FILTER_CONDITION0 *filterCondition;
FWPS_ACTION0 action;
UINT64 context;
FWPM_PROVIDER_CONTEXT0 *providerContext;
} FWPS_FILTER0;
Membros
filterId
Um identificador de tempo de execução que identifica o filtro no mecanismo de filtro.
weight
Uma estrutura FWP_VALUE0 que contém um valor que especifica a importância do filtro em relação a outros filtros no mecanismo de filtro. Os filtros com um valor de peso mais alto são invocados primeiro. O tipo de dados especificado na estrutura FWP_VALUE0 é FWP_UINT64 ou FWP_EMPTY. Se o tipo de dados especificado na estrutura FWP_VALUE0 for FWP_EMPTY, o mecanismo de filtro atribuirá automaticamente um peso ao filtro com base em quão específico o filtro testa os dados em comparação com os outros filtros no mecanismo de filtro.
subLayerWeight
Um valor que especifica a importância da subcamada do filtro em relação aos outros subcaminhos no mecanismo de filtro. Os filtros localizados em uma subcamada com um valor subLayerWeight mais alto são invocados primeiro.
flags
Sinalizadores que especificam ações que a função de texto explicativo classifyFn0 de um texto explicativo deve tomar ao processar dados de rede. Os possíveis sinalizadores são:
Valor | Significado |
---|---|
FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT | Esse sinalizador indica para a função de texto explicativo classifyFn0 de um texto explicativo que ele sempre deve limpar o sinalizador FWPS_RIGHT_ACTION_WRITE quando retorna FWP_ACTION_BLOCK ou FWP_ACTION_PERMIT para a ação sugerida. Se esse sinalizador não estiver definido, a função de texto explicativo classifyFn0 de um texto explicativo só deverá limpar o sinalizador FWPS_RIGHT_ACTION_WRITE quando retornar FWP_ACTION_BLOCK para a ação sugerida. |
FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED | Esse sinalizador indica para a função de texto explicativo classifyFn0 de um texto explicativo que, se o texto explicativo não estiver registrado, o texto explicativo deverá ser tratado como um filtro de permissão. |
FWPS_FILTER_FLAG_OR_CONDITIONS | Há várias condições para o mesmo campo. OR semântica aplicada. |
FWPS_FILTER_FLAG_HAS_SECURITY_REALM_PROVIDER_CONTEXT | O filtro faz referência a um contexto de provedor para id de realm de segurança IPsec. |
FWPS_FILTER_FLAG_SILENT_MODE | O filtro está no modo silencioso. |
FWPS_FILTER_FLAG_IPSEC_NO_ACQUIRE_INITIATE | Não inicie a aquisição de IPsec se o pacote corresponder a uma política IPsec de um filtro com esse sinalizador. |
FWPS_FILTER_FLAG_RESERVED0 | Reservado para uso do sistema. |
FWPS_FILTER_FLAG_RESERVED1 | Reservado para uso do sistema. |
FWPS_FILTER_FLAG_RESERVED2 | Reservado para uso do sistema. |
numFilterConditions
O número de estruturas FWPS_FILTER_CONDITION0 na matriz apontada pelo membro filterCondition . Esse membro pode ser zero.
filterCondition
Um ponteiro para uma matriz de estruturas FWPS_FILTER_CONDITION0 . Essas estruturas definem as condições de filtragem em tempo de execução para o filtro. Se o membro numFilterConditions for zero, esse ponteiro será NULL.
action
Uma estrutura FWPS_ACTION0 que especifica a ação que o filtro deve executar se todas as condições de filtragem do filtro forem verdadeiras.
context
Um valor de contexto associado ao filtro. Um texto explicativo pode definir esse membro para apontar para uma estrutura de contexto fornecida pelo driver de texto explicativo de dentro da função de texto explicativo notifyFn0 do driver de texto explicativo quando o filtro é adicionado ao mecanismo de filtro. Essa estrutura de contexto, opaca para o mecanismo de filtro, pode ser usada pela função de texto explicativo classifyFn0 do driver de texto explicativo para preservar quaisquer dados específicos do driver ou informações de estado entre chamadas pelo mecanismo de filtro para a função de texto explicativo classifyFn0 do driver de texto explicativo.
providerContext
Um ponteiro para o contexto do provedor, que é formatado como uma estrutura FWPM_PROVIDER_CONTEXT0 . Se o filtro usar um texto explicativo e o texto explicativo tiver o sinalizador FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT definido, esse membro conterá o contexto do provedor da estrutura de FWPM_FILTER0 correspondente. Caso contrário, esse parâmetro será NULL.
Comentários
O mecanismo de filtro passa um ponteiro para uma estrutura FWPS_FILTER0 para as funções de texto explicativo notifyFn0 e classifyFn0 de um texto explicativo.
A ação de um filtro será executada somente se todas as condições de filtragem do filtro forem verdadeiras. Se nenhuma condição de filtragem for especificada no filtro, a ação especificada será sempre executada.
O membro ProviderContext fornece um mecanismo para um driver de texto explicativo recuperar contextos de provedor sem chamar o BFE (mecanismo de filtragem base).
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows Vista. |
Cabeçalho | fwpstypes.h (inclua Fwpsk.h) |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de