FwpsFlowRemoveContext0, fonction (fwpsk.h)

  • Article

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