Partager via

FwpmCalloutDeleteById0, fonction (fwpmk.h)

  • Article

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

Syntaxe

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

Paramètres

[in] engineHandle

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

[in] id

Identificateur d’exécution de la légende en cours de suppression du moteur de filtre. Il doit s’agir de l’identificateur d’exécution retourné lorsque le pilote de légende a appelé la fonction FwpmCalloutAdd0 pour ajouter la légende au moteur de filtre.

Valeur de retour

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

Retourner le code Description
STATUS_SUCCESS La légende a été correctement 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 à l’identificateur d’exécution spécifié dans l’ID paramètre.
autres codes NTSTATUS Une erreur s’est produite.

Remarques

Un pilote de légende appelle la fonction FwpmCalloutDeleteById0 pour supprimer une légende du moteur de filtre, à l’aide de l’identificateur d’exécution 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 un mode utilisateur application de gestion de la plateforme de filtrage Windows.

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

FwpmCalloutDeleteById0 est une version spécifique de FwpmCalloutDeleteById. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows Vista.
plateforme cible Universel
d’en-tête fwpmk.h (include Fwpmk.h)
bibliothèque Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Voir aussi