estrutura FWPM_PROVIDER_CONTEXT2 (fwpmtypes.h)

Artigo
03/05/2024

A estrutura FWPM_PROVIDER_CONTEXT2 armazena o estado associado a um contexto de provedor. FWPM_PROVIDER_CONTEXT0 está disponível.

Sintaxe

typedef struct FWPM_PROVIDER_CONTEXT2_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY1    *keyingPolicy;
    IPSEC_TRANSPORT_POLICY2 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY2    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY2    *authipQmTunnelPolicy;
    IKEEXT_POLICY2          *ikeMmPolicy;
    IKEEXT_POLICY2          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY2    *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT2;

Membros

providerContextKey

Tipo: GUID

Identifica exclusivamente o contexto do provedor. Se o GUID for inicializado zero na chamada para FwpmProviderContextAdd2, o BFE (Mecanismo de Filtragem Base) gerará um.

displayData

Tipo: FWPM_DISPLAY_DATA0

Permite que os contextos do provedor sejam anotados em uma forma legível por humanos. A estrutura FWPM_DISPLAY_DATA0 é necessária.

flags

Tipo: UINT32

Valores possíveis:

Sinalizador de contexto do provedor	Significado
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	O objeto é persistente, ou seja, ele sobrevive em toda a parada/início do BFE.
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL	Reservado para uso interno.

providerKey

Tipo: GUID*

GUID do provedor de política que gerencia esse objeto.

providerData

Tipo: FWP_BYTE_BLOB

Dados opcionais específicos do provedor que permitem que os provedores armazenem informações de contexto adicionais com o objeto .

type

Tipo: FWPM_PROVIDER_CONTEXT_TYPE

O tipo de contexto do provedor.

keyingPolicy

Tipo: IPSEC_KEYING_POLICY1*

Disponível quando o tipo é FWPM_IPSEC_KEYING_CONTEXT.

ikeQmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT.

ikeQmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT.

authipQmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

[case()] [exclusivo]

authipQmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT.

ikeMmPolicy

Tipo: IKEEXT_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_IKE_MM_CONTEXT.

authIpMmPolicy

Tipo: IKEEXT_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_AUTHIP_MM_CONTEXT.

dataBuffer

Tipo: FWP_BYTE_BLOB*

Disponível quando o tipo é FWPM_GENERAL_CONTEXT.

classifyOptions

Tipo: FWPM_CLASSIFY_OPTIONS0*

Disponível quando o tipo é FWPM_CLASSIFY_OPTIONS_CONTEXT.

ikeV2QmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT.

ikeV2QmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXT.

ikeV2MmPolicy

Tipo: IKEEXT_POLICY2*

Disponível quando o tipo é FWPM_IPSEC_IKEV2_MM_CONTEXT.

idpOptions

Tipo: IPSEC_DOSP_OPTIONS0*

Disponível quando o tipo é FWPM_IPSEC_DOSP_CONTEXT.

providerContextId

Tipo: UINT64

LUID identificando o contexto. Esse é o valor de contexto armazenado na estrutura FWPS_FILTER1 para filtros que fazem referência a um contexto de provedor. A estrutura FWPS_FILTER1 está documentada no WDK.

Comentários

Os primeiros sete elementos da união são informações fornecidas ao adicionar objetos.

O último elemento é informações adicionais retornadas ao obter/enumerar objetos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho	fwpmtypes.h