Fonction FwpsCalloutUnregisterById0 (fwpsk.h)
La fonction FwpsCalloutUnregisterById0 annule l’inscription d’une légende du moteur de filtre.
Syntaxe
NTSTATUS FwpsCalloutUnregisterById0(
[in] const UINT32 calloutId
);
Paramètres
[in] calloutId
Identificateur d’exécution de la légende en cours d’annulation de l’inscription du moteur de filtre. Il doit s’agir de l’identificateur d’exécution qui a été retourné lorsque le pilote de légende a appelé la fonction FwpsCalloutRegister0 ou FwpsCalloutRegister1 pour inscrire la légende auprès du moteur de filtre.
Valeur retournée
La fonction FwpsCalloutUnregisterById0 retourne l’un des codes NTSTATUS suivants.
Code de retour | Description |
---|---|
|
La légende a été correctement désinscrit du moteur de filtre. |
|
Il existe un ou plusieurs flux de données en cours de traitement par la légende qui ont un contexte exceptionnel associé au flux de données. Un pilote de légende doit appeler la fonction FwpsFlowRemoveContext0 pour chacun de ces flux de données afin de supprimer le contexte associé. Une fois le contexte supprimé de chacun de ces flux de données, le pilote de légende doit rappeler la fonction FwpsCalloutUnregisterById0 pour terminer l’annulation de l’inscription de la légende du moteur de filtre. |
|
Aucune légende inscrite auprès du moteur de filtre ne correspond à l’identificateur d’exécution spécifié dans le paramètre calloutId . |
|
La légende est déjà en cours d’inscription ou de désinscription dans un autre thread. |
|
Une erreur est survenue. |
Remarques
Un pilote de légende appelle la fonction FwpsCalloutUnregisterById0 pour désinscrire une légende du moteur de filtre, en utilisant l’identificateur d’exécution pour identifier la légende à désinscrire. Cette fonction réussit même s’il existe des filtres dans le moteur de filtre qui spécifient la légende pour l’action du filtre. Dans ce cas, les filtres avec un type d’action de FWP_ACTION_CALLOUT_TERMINATING ou de FWP_ACTION_CALLOUT_UNKNOWN sont traités comme FWP_ACTION_BLOCK, et les filtres avec un type d’action de FWP_ACTION_CALLOUT_INSPECTION sont ignorés une fois que la légende a été désinscrire du moteur de filtre.
Un pilote de légende ne peut pas être déchargé tant que toutes les légendes précédemment inscrites auprès du moteur de filtre n’ont pas été correctement désinscrits.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows Vista. |
Plateforme cible | Universal |
En-tête | fwpsk.h (include Fwpsk.h) |
Bibliothèque | Fwpkclnt.lib |
IRQL | PASSIVE_LEVEL |