FwpsFlowRemoveContext0, fonction (fwpsk.h)

Article
02/29/2024

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

RemarqueFwpsFlowRemoveContext0 est une version spécifique de FwpsFlowRemoveContext. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of 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 par le biais de la valeur de métadonnées FWPS_METADATA_FIELD_FLOW_HANDLE qui a été passée à la fonction de légende classifyFn 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 que celui qu’il a spécifié quand 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 FwpsCalloutRegister1 pour inscrire la légende auprès du moteur de filtre.

Valeur retournée

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

Code de retour	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 status	Une erreur est survenue.

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 façon asynchrone, car une classification de légende active est en cours.

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	<= DISPATCH_LEVEL

Voir aussi

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn

Partager via