structure FWPM_PROVIDER_CONTEXT2 (fwpmtypes.h)

Article
04/30/2024

La structure FWPM_PROVIDER_CONTEXT2 stocke l’état associé à un contexte de fournisseur. FWPM_PROVIDER_CONTEXT0 est disponible.

Syntaxe

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;

Membres

providerContextKey

Type : GUID

Identifie de manière unique le contexte du fournisseur. Si le GUID est initialisé à zéro dans l’appel à FwpmProviderContextAdd2, le moteur de filtrage de base (BFE) en génère un.

displayData

Type : FWPM_DISPLAY_DATA0

Permet d’annoter les contextes de fournisseur sous une forme lisible par l’homme. La structure FWPM_DISPLAY_DATA0 est requise.

flags

Type : UINT32

Valeurs possibles :

Indicateur de contexte du fournisseur	Signification
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	L’objet est persistant, c’est-à-dire qu’il survit à l’arrêt/au démarrage BFE.
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL	Réservé à un usage interne.

providerKey

Type : GUID*

GUID du fournisseur de stratégie qui gère cet objet.

providerData

Type : FWP_BYTE_BLOB

Données facultatives spécifiques au fournisseur qui permettent aux fournisseurs de stocker des informations de contexte supplémentaires avec l’objet .

type

Type : FWPM_PROVIDER_CONTEXT_TYPE

Type de contexte de fournisseur.

keyingPolicy

Type : IPSEC_KEYING_POLICY1*

Disponible lorsque le type est FWPM_IPSEC_KEYING_CONTEXT.

ikeQmTransportPolicy

Type : IPSEC_TRANSPORT_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT.

ikeQmTunnelPolicy

Type : IPSEC_TUNNEL_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT.

authipQmTransportPolicy

Type : IPSEC_TRANSPORT_POLICY2*

[cas()] [unique]

authipQmTunnelPolicy

Type : IPSEC_TUNNEL_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT.

ikeMmPolicy

Type : IKEEXT_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_IKE_MM_CONTEXT.

authIpMmPolicy

Type : IKEEXT_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_MM_CONTEXT.

dataBuffer

Type : FWP_BYTE_BLOB*

Disponible lorsque le type est FWPM_GENERAL_CONTEXT.

classifyOptions

Type : FWPM_CLASSIFY_OPTIONS0*

Disponible lorsque le type est FWPM_CLASSIFY_OPTIONS_CONTEXT.

ikeV2QmTunnelPolicy

Type : IPSEC_TUNNEL_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT.

ikeV2QmTransportPolicy

Type : IPSEC_TRANSPORT_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXT.

ikeV2MmPolicy

Type : IKEEXT_POLICY2*

Disponible lorsque le type est FWPM_IPSEC_IKEV2_MM_CONTEXT.

idpOptions

Type : IPSEC_DOSP_OPTIONS0*

Disponible lorsque le type est FWPM_IPSEC_DOSP_CONTEXT.

providerContextId

Type : UINT64

LUID identifiant le contexte. Il s’agit de la valeur de contexte stockée dans la structure FWPS_FILTER1 pour les filtres qui référencent un contexte de fournisseur. La structure FWPS_FILTER1 est documentée dans le WDK.

Remarques

Les sept premiers éléments de l’union sont des informations fournies lors de l’ajout d’objets.

Le dernier élément est des informations supplémentaires retournées lors de l’obtention/énumération d’objets.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	fwpmtypes.h