estructura FWPM_PROVIDER_CONTEXT2 (fwpmtypes.h)

Artículo
04/30/2024

La estructura FWPM_PROVIDER_CONTEXT2 almacena el estado asociado a un contexto de proveedor. FWPM_PROVIDER_CONTEXT0 está disponible.

Sintaxis

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;

Miembros

providerContextKey

Tipo: GUID

Identifica de forma única el contexto del proveedor. Si el GUID se inicializa con cero en la llamada a FwpmProviderContextAdd2, el motor de filtrado base (BFE) generará uno.

displayData

Tipo: FWPM_DISPLAY_DATA0

Permite anotar contextos de proveedor en un formato legible. Se requiere la estructura FWPM_DISPLAY_DATA0 .

flags

Tipo: UINT32

Valores posibles:

Marca de contexto del proveedor	Significado
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	El objeto es persistente, es decir, sobrevive a través de la detención/inicio de BFE.
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL	Reservado para uso interno.

providerKey

Tipo: GUID*

GUID del proveedor de directivas que administra este objeto.

providerData

Tipo: FWP_BYTE_BLOB

Datos opcionales específicos del proveedor que permiten a los proveedores almacenar información de contexto adicional con el objeto .

type

Tipo: FWPM_PROVIDER_CONTEXT_TYPE

Tipo de contexto del proveedor.

keyingPolicy

Tipo: IPSEC_KEYING_POLICY1*

Disponible cuando se FWPM_IPSEC_KEYING_CONTEXTel tipo.

ikeQmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

Disponible cuando se FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXTel tipo.

ikeQmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponible cuando se FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXTel tipo.

authipQmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

[case()] [único]

authipQmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponible cuando se FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXTel tipo.

ikeMmPolicy

Tipo: IKEEXT_POLICY2*

Disponible cuando se FWPM_IPSEC_IKE_MM_CONTEXTel tipo.

authIpMmPolicy

Tipo: IKEEXT_POLICY2*

Disponible cuando se FWPM_IPSEC_AUTHIP_MM_CONTEXTel tipo.

dataBuffer

Tipo: FWP_BYTE_BLOB*

Disponible cuando se FWPM_GENERAL_CONTEXTel tipo.

classifyOptions

Tipo: FWPM_CLASSIFY_OPTIONS0*

Disponible cuando se FWPM_CLASSIFY_OPTIONS_CONTEXTel tipo.

ikeV2QmTunnelPolicy

Tipo: IPSEC_TUNNEL_POLICY2*

Disponible cuando se FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXTel tipo.

ikeV2QmTransportPolicy

Tipo: IPSEC_TRANSPORT_POLICY2*

Disponible cuando se FWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXTel tipo.

ikeV2MmPolicy

Tipo: IKEEXT_POLICY2*

Disponible cuando se FWPM_IPSEC_IKEV2_MM_CONTEXTel tipo.

idpOptions

Tipo: IPSEC_DOSP_OPTIONS0*

Disponible cuando se FWPM_IPSEC_DOSP_CONTEXTel tipo.

providerContextId

Tipo: UINT64

LUID que identifica el contexto. Este es el valor de contexto almacenado en la estructura FWPS_FILTER1 para los filtros que hacen referencia a un contexto de proveedor. La estructura FWPS_FILTER1 se documenta en el WDK.

Comentarios

Los siete primeros elementos de la unión son información proporcionada al agregar objetos.

El último elemento es información adicional devuelta al obtener o enumerar objetos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	fwpmtypes.h