estructura FWPM_PROVIDER_CONTEXT3 (fwpmtypes.h)

Artículo
04/30/2024

Almacena el estado asociado a un contexto de proveedor. FWPM_PROVIDER_CONTEXT0, FWPM_PROVIDER_CONTEXT1 y FWPM_PROVIDER_CONTEXT2 están disponibles.

Sintaxis

typedef struct FWPM_PROVIDER_CONTEXT3_ {
  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_POLICY3                     *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY3                     *authipQmTunnelPolicy;
    IKEEXT_POLICY2                           *ikeMmPolicy;
    IKEEXT_POLICY2                           *authIpMmPolicy;
    FWP_BYTE_BLOB                            *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0                   *classifyOptions;
    IPSEC_TUNNEL_POLICY3                     *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2                           *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0                      *idpOptions;
    FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 *networkConnectionPolicy;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT3;

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.

networkConnectionPolicy

Puntero a una estructura de FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 que contiene el número de directivas de conexión de red y una lista de esas directivas con formato.

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. Se devuelve información adicional al obtener o enumerar objetos.