FwpsCalloutUnregisterByKey0, fonction (fwpsk.h)

La fonction FwpsCalloutUnregisterByKey0 annule l’inscription d’une légende à partir du moteur de filtre.

RemarqueFwpsCalloutUnregisterByKey0 est une version spécifique de FwpsCalloutUnregisterByKey. Pour plus d’informations, voir PAM Version-Independent noms et ciblage des versions spécifiques de Windows .
 

Syntaxe

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

Paramètres

[in] calloutKey

Pointeur vers un GUID qui identifie de manière unique la légende qui est non inscrite à partir du moteur de filtre. Il doit s’agir d’un pointeur vers le même GUID spécifié lorsque le pilote de légende a appelé les fonctions FwpsCalloutRegister0 ou FwpsCalloutRegister1 pour inscrire la légende auprès du moteur de filtre.

Valeur de retour

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

Code de retour Description
STATUS_SUCCESS
La légende a été correctement annulée à partir du moteur de filtre.
STATUS_DEVICE_BUSY
Il existe un ou plusieurs flux de données traités 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 pour supprimer le contexte associé. Une fois le contexte supprimé de chacun de ces flux de données, le pilote de légende doit appeler à nouveau la fonction FwpsCalloutUnregisterByKey0 pour annuler l’inscription de la légende du moteur de filtre.
STATUS_FWP_CALLOUT_NOT_FOUND
Il n’existe pas de légende inscrite auprès du moteur de filtre qui correspond au GUID spécifié dans le paramètre calloutKey .
STATUS_FWP_IN_USE
La légende est déjà en cours d’inscription ou non inscrite dans un autre thread.
Autres codes d’état
Une erreur est survenue.

Remarques

Un pilote de légende appelle la fonction FwpsCalloutUnregisterByKey0 pour annuler l’inscription d’une légende à partir du moteur de filtre, à l’aide de la clé GUID pour identifier la légende à annuler l’inscription. Cette fonction réussit même s’il existe des filtres dans le moteur de filtre qui spécifient la légende de 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é annulée à partir du moteur de filtre.

Un pilote de légende ne peut pas être déchargé jusqu’à ce que toutes les légendes qui ont été précédemment inscrites auprès du moteur de filtre n’aient pas été enregistrées correctement.

Configuration requise

   
Client minimal pris en charge Disponible à partir de Windows Vista.
Plateforme cible Universal
En-tête fwpsk.h (inclure Fwpsk.h)
Bibliothèque Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Voir aussi

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

Types de légendes