structure FWPM_PROVIDER_CONTEXT2 (fwpmtypes.h)
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 |