structure FWPM_CALLOUT0 (fwpmtypes.h)

  • Article

La structure FWPM_CALLOUT0 stocke l’état associé à une légende.

Syntaxe

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

Membres

calloutKey

Identifie de manière unique la session.

Si le GUID est initialisé à zéro dans l’appel à FwpmCalloutAdd0, le moteur de filtrage de base (BFE) en génère un.

displayData

Une structure FWPM_DISPLAY_DATA0 qui contient des annotations lisibles par l’homme associées à la légende. Le membre de nom de la structure FWPM_DISPLAY_DATA0 est requis.

flags

Valeur Signification
FWPM_CALLOUT_FLAG_PERSISTENT
 La légende est persistante entre les redémarrages. Par conséquent, il peut être référencé par des filtres au démarrage et d’autres filtres persistants.
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT
 La légende doit accéder au contexte du fournisseur stocké dans le filtre appelant la légende. Si cet indicateur est défini, le contexte du fournisseur est copié à partir de la structure [FWPM_FILTER0](/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0) vers la structure FWPS_FILTER0 . La structure FWPS_FILTER0 est documentée dans le WDK.
FWPM_CALLOUT_FLAG_REGISTERED
 La légende est actuellement inscrite dans le noyau. Cet indicateur ne doit pas être défini lors de l’ajout de nouvelles légendes. Il est utilisé uniquement pour interroger l’état des légendes existantes.

providerKey

Identifie de manière unique le fournisseur associé à la légende. Si le membre n’est pas NULL, seuls les objets associés au fournisseur spécifié sont retournés.

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 .

applicableLayer

Spécifie la couche dans laquelle la légende peut être utilisée. Seuls les filtres de cette couche peuvent appeler la légende. Pour plus d’informations, consultez Filtrage des identificateurs de couche.

calloutId

LUID identifiant la légende. Il s’agit du calloutId stocké dans la structure FWPS_ACTION0 pour les filtres qui appellent une légende. La structure FWPS_ACTION0 est documentée dans le WDK.

Remarques

Les six premiers membres de cette structure contiennent des données fournies lors de l’ajout d’objets.

Le dernier membre, calloutId, fournit des informations supplémentaires retournées lors de l’obtention/énumération d’objets.

FWPM_CALLOUT0 est une implémentation spécifique de FWPM_CALLOUT. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows .

Configuration requise

Condition requise Valeur
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