Fonction FwpmCalloutDeleteByKey0 (fwpmk.h)

  • Article

La fonction FwpmCalloutDeleteByKey0 supprime une légende du moteur de filtre.

RemarqueFwpmCalloutDeleteByKey0 est une version spécifique de FwpmCalloutDeleteByKey. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows .
 

Syntaxe

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

Paramètres

[in] engineHandle

Handle pour une session ouverte au moteur de filtre. Un pilote de légende appelle la fonction FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.

[in] key

Pointeur vers un GUID qui identifie de manière unique la légende supprimée du moteur de filtre. Il doit s’agir d’un pointeur vers le même GUID que celui spécifié lorsque le pilote de légende a appelé la fonction FwpmCalloutAdd0 pour ajouter la légende au moteur de filtre.

Valeur retournée

La fonction FwpmCalloutDeleteByKey0 retourne l’un des codes NTSTATUS suivants.

Code de retour Description
STATUS_SUCCESS
 La légende a été supprimée du moteur de filtre.
STATUS_FWP_IN_USE
 Un ou plusieurs filtres dans le moteur de filtre spécifient la légende de l’action du filtre.
STATUS_FWP_CALLOUT_NOT_FOUND
 Il n’existe pas de légende dans le moteur de filtre qui correspond au GUID spécifié dans le paramètre de clé .
Autres codes status
 Une erreur est survenue.

Remarques

Un pilote de légende appelle la fonction FwpmCalloutDeleteByKey0 pour supprimer une légende du moteur de filtre, en utilisant la clé GUID pour identifier la légende à supprimer.

Les pilotes de légende ne suppriment généralement pas leurs légendes du moteur de filtre. Dans la plupart des cas, cela est géré par une application de gestion de la plateforme de filtrage Windows en mode utilisateur.

Une légende ne peut être supprimée du moteur de filtre que s’il n’existe aucun filtre dans le moteur de filtre qui spécifie la légende pour l’action du filtre.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
Plateforme cible Universal
En-tête fwpmk.h (incluez Fwpmk.h)
Bibliothèque Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Voir aussi

FwpmCalloutAdd0

FwpmCalloutDeleteById0

FwpmEngineOpen0