Fonction FwpmCalloutDeleteByKey0 (fwpmk.h)
La fonction FwpmCalloutDeleteByKey0 supprime une légende du moteur de filtre.
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 |
|---|---|
|
La légende a été supprimée du moteur de filtre. |
|
Un ou plusieurs filtres dans le moteur de filtre spécifient la légende de l’action du filtre. |
|
Il n’existe pas de légende dans le moteur de filtre qui correspond au GUID spécifié dans le paramètre de clé . |
|
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 |