FWPM_PROVIDER_CONTEXT3 structure (fwpmtypes.h)
Stocke l’état associé à un contexte de fournisseur. FWPM_PROVIDER_CONTEXT0, FWPM_PROVIDER_CONTEXT1 et FWPM_PROVIDER_CONTEXT2 sont disponibles.
Syntaxe
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;
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 aux contextes du fournisseur d’être annotés sous une forme lisible par l’utilisateur. 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/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 du 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*
[case()] [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.
networkConnectionPolicy
Pointeur vers une structure de FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 contenant le nombre de stratégies de connexion réseau et une liste de ces stratégies mises en forme.
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. Il s’agit d’informations supplémentaires retournées lors de l’obtention/de l’énumération d’objets.
Remarques
Les sept premiers éléments de l’union sont des informations fournies lors de l’ajout d’objets.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | fwpmtypes.h |