FWPM_PROVIDER_CONTEXT1 estructura (fwpmtypes.h)

Artículo
02/29/2024

La estructura de FWPM_PROVIDER_CONTEXT1 almacena el estado asociado a un contexto de proveedor. FWPM_PROVIDER_CONTEXT2 está disponible. Para Windows Vista, FWPM_PROVIDER_CONTEXT0 está disponible.

Sintaxis

typedef struct FWPM_PROVIDER_CONTEXT1_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY0    *keyingPolicy;
    IPSEC_TRANSPORT_POLICY1 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY1 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *authipQmTunnelPolicy;
    IKEEXT_POLICY1          *ikeMmPolicy;
    IKEEXT_POLICY1          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY1    *ikeV2QmTunnelPolicy;
    IKEEXT_POLICY1          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT1;

Miembros

providerContextKey

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

displayData

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

flags

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 o inicio de BFE.

providerKey

GUID del proveedor de directivas que administra este objeto.

providerData

Estructura FWP_BYTE_BLOB que contiene datos opcionales específicos del proveedor que permite a los proveedores almacenar información de contexto adicional con el objeto .

type

Valor de FWPM_PROVIDER_CONTEXT_TYPE que especifica el tipo de contexto del proveedor.

keyingPolicy

Disponible cuando el tipo se FWPM_IPSEC_KEYING_CONTEXT.

Consulte IPSEC_KEYING_POLICY0 para obtener más información.

ikeQmTransportPolicy

Disponible cuando se FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXTel tipo.

Consulte IPSEC_TRANSPORT_POLICY1 para obtener más información.

ikeQmTunnelPolicy

Disponible cuando se FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXTel tipo.

Consulte IPSEC_TUNNEL_POLICY1 para obtener más información.

authipQmTransportPolicy

Disponible cuando el tipo es FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT.

Consulte IPSEC_TRANSPORT_POLICY1 para obtener más información.

authipQmTunnelPolicy

Disponible cuando el tipo se FWPM_IPSEC_AUTHIP_QM_TUNNEL_CONTEXT.

Consulte IPSEC_TUNNEL_POLICY1 para obtener más información.

ikeMmPolicy

Disponible cuando el tipo está FWPM_IPSEC_IKE_MM_CONTEXT.

Consulte IKEEXT_POLICY1 para obtener más información.

authIpMmPolicy

Disponible cuando el tipo es FWPM_IPSEC_AUTHIP_MM_CONTEXT.

Consulte IKEEXT_POLICY1 para obtener más información.

dataBuffer

Disponible cuando el tipo se FWPM_GENERAL_CONTEXT.

Consulte FWP_BYTE_BLOB para obtener más información.

classifyOptions

Disponible cuando el tipo es FWPM_CLASSIFY_OPTIONS_CONTEXT.

Consulte FWPM_CLASSIFY_OPTIONS0 para obtener más información.

ikeV2QmTunnelPolicy

Disponible cuando el tipo es FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT.

Consulte IPSEC_TUNNEL_POLICY1 para obtener más información.

ikeV2MmPolicy

Disponible cuando el tipo es FWPM_IPSEC_IKEV2_MM_CONTEXT.

Consulte IKEEXT_POLICY1 para obtener más información.

idpOptions

Disponible cuando el tipo es FWPM_IPSEC_DOSP_CONTEXT.

Consulte IPSEC_DOSP_OPTIONS0 para obtener más información.

providerContextId

LUID que identifica el contexto. Este es el valor de contexto almacenado en la estructura de 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 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	fwpmtypes.h