FwpsFlowRemoveContext0, fonction (fwpsk.h)

Article
02/07/2025

La fonction FwpsFlowRemoveContext0 supprime un contexte précédemment associé d’un flux de données.

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

Syntaxe

NTSTATUS FwpsFlowRemoveContext0(
  [in] UINT64 flowId,
  [in] UINT16 layerId,
  [in] UINT32 calloutId
);

Paramètres

[in] flowId

Identificateur d’exécution qui spécifie le flux de données à partir duquel supprimer le contexte. L’identificateur d’exécution d’un flux de données est fourni à un pilote de légende via la valeur de métadonnées FWPS_METADATA_FIELD_FLOW_HANDLE qui a été passée au classifieFn fonction de légende du pilote de légende.

[in] layerId

Identificateur d’exécution de la couche de filtrage à partir de laquelle le contexte est supprimé. Pour plus d’informations, consultez identificateurs de couche de filtrage au moment de l’exécution. Un pilote de légende doit spécifier le même identificateur qu’il a spécifié lorsqu’il a appelé la fonction FwpsFlowAssociateContext0 pour associer le contexte au flux de données.

[in] calloutId

Identificateur d’exécution de la légende dans le moteur de filtre. Cet identificateur a été retourné lorsque le pilote de légende a appelé les fonctions FwpsCalloutRegister0 ou fonctions FwpsCalloutRegister1 pour inscrire la légende auprès du moteur de filtre.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	Le contexte a été supprimé du flux de données.
STATUS_UNSUCCESSFUL	Aucun contexte n’est actuellement associé au flux de données.
STATUS_PENDING	Une classification de légende active est en cours.
Autres codes d’état	Une erreur s’est produite.

Remarques

Si la fonction FwpsFlowRemoveContext0 retourne STATUS_SUCCESS, FwpsFlowRemoveContext0 appelle la fonction de légende flowDeleteFn de manière synchrone. Si FwpsFlowRemoveContext0 retourne STATUS_PENDING, FwpsFlowRemoveContext0 appelle flowDeleteFn de manière asynchrone, car une classification de légende active est en cours.

Exigences

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

Voir aussi

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifierFn

flowDeleteFn

Partager via