structure FWPM_PROVIDER_CONTEXT0 (fwpmtypes.h)

Article
08/23/2023

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

Syntaxe

typedef struct FWPM_PROVIDER_CONTEXT0_ {
  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_POLICY0 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY0    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY0 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY0    *authipQmTunnelPolicy;
    IKEEXT_POLICY0          *ikeMmPolicy;
    IKEEXT_POLICY0          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT0;

Membres

providerContextKey

Identifie de manière unique le contexte du fournisseur. Si le GUID est initialisé à zéro dans l’appel à FwpmProviderContextAdd0, 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_POLICY0 .

ikeQmTunnelPolicy

Disponible lorsque le type est FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT.

Pour plus d’informations , consultez IPSEC_TUNNEL_POLICY0 .

authipQmTransportPolicy

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT.

Pour plus d’informations, consultez IPSEC_TRANSPORT_POLICY0 .

authipQmTunnelPolicy

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_QM_TUNNEL_CONTEXT.

Pour plus d’informations , consultez IPSEC_TUNNEL_POLICY0 .

ikeMmPolicy

Disponible lorsque le type est FWPM_IPSEC_IKE_MM_CONTEXT.

Pour plus d’informations, consultez IKEEXT_POLICY0 .

authIpMmPolicy

Disponible lorsque le type est FWPM_IPSEC_AUTHIP_MM_CONTEXT.

Pour plus d’informations, consultez IKEEXT_POLICY0 .

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 .

providerContextId

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

Notes

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.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	fwpmtypes.h

Voir aussi

Structures d’API de plateforme de filtrage Windows

Partager via