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