structure FWPM_PROVIDER_CONTEXT1 (fwpmtypes.h)

Article
03/02/2024

La structure FWPM_PROVIDER_CONTEXT1 stocke l’état associé à un contexte de fournisseur. FWPM_PROVIDER_CONTEXT2 est disponible. Pour Windows Vista, FWPM_PROVIDER_CONTEXT0 est disponible.

Syntaxe

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;

Membres

providerContextKey

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

displayData

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

flags

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.

providerKey

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

providerData

Une structure FWP_BYTE_BLOB qui contient des données facultatives spécifiques au fournisseur qui permet aux fournisseurs de stocker des informations de contexte supplémentaires avec l’objet.

type

Valeur FWPM_PROVIDER_CONTEXT_TYPE spécifiant le type de contexte du fournisseur..

keyingPolicy

Disponible lorsque le type est FWPM_IPSEC_KEYING_CONTEXT.

Pour plus d’informations, consultez IPSEC_KEYING_POLICY0 .

ikeQmTransportPolicy

Disponible lorsque le type est FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT.

Pour plus d’informations, consultez IPSEC_TRANSPORT_POLICY1 .

ikeQmTunnelPolicy

Disponible lorsque le type est FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT.

Pour plus d’informations , consultez IPSEC_TUNNEL_POLICY1 .

authipQmTransportPolicy

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT.

Pour plus d’informations, consultez IPSEC_TRANSPORT_POLICY1 .

authipQmTunnelPolicy

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_QM_TUNNEL_CONTEXT.

Pour plus d’informations , consultez IPSEC_TUNNEL_POLICY1 .

ikeMmPolicy

Disponible lorsque le type est FWPM_IPSEC_IKE_MM_CONTEXT.

Pour plus d’informations, consultez IKEEXT_POLICY1 .

authIpMmPolicy

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_MM_CONTEXT.

Pour plus d’informations, consultez IKEEXT_POLICY1 .

dataBuffer

Disponible lorsque le type est FWPM_GENERAL_CONTEXT.

Pour plus d’informations, consultez FWP_BYTE_BLOB .

classifyOptions

Disponible lorsque le type est FWPM_CLASSIFY_OPTIONS_CONTEXT.

Pour plus d’informations, consultez FWPM_CLASSIFY_OPTIONS0 .

ikeV2QmTunnelPolicy

Disponible lorsque le type est FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT.

Pour plus d’informations , consultez IPSEC_TUNNEL_POLICY1 .

ikeV2MmPolicy

Disponible lorsque le type est FWPM_IPSEC_IKEV2_MM_CONTEXT.

Pour plus d’informations, consultez IKEEXT_POLICY1 .

idpOptions

Disponible lorsque le type est FWPM_IPSEC_DOSP_CONTEXT.

Pour plus d’informations, consultez IPSEC_DOSP_OPTIONS0 .

providerContextId

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 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	fwpmtypes.h