Funzione FwpsFlowRemoveContext0 (fwpsk.h)

Articolo
05/04/2023

La funzione FwpsFlowRemoveContext0 rimuove un contesto associato in precedenza da un flusso di dati.

NotaFwpsFlowRemoveContext0 è una versione specifica di FwpsFlowRemoveContext. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Sintassi

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

Parametri

[in] flowId

Identificatore di runtime che specifica il flusso di dati da cui rimuovere il contesto. L'identificatore di runtime per un flusso di dati viene fornito a un driver di callout tramite il valore dei metadati FWPS_METADATA_FIELD_FLOW_HANDLE passato alla funzione di callout del driver di callout del callout.

[in] layerId

Identificatore di runtime per il livello di filtro da cui viene rimosso il contesto. Per altre informazioni, vedere Identificatori del livello di filtro in fase di esecuzione. Un driver di callout deve specificare lo stesso identificatore specificato quando ha chiamato la funzione FwpsFlowAssociateContext0 per associare il contesto al flusso di dati.

[in] calloutId

Identificatore di runtime per il callout nel motore di filtro. Questo identificatore è stato restituito quando il driver callout ha chiamato le funzioni FwpsCalloutRegister0 o FwpsCalloutRegister1 per registrare il callout con il motore di filtro.

Valore restituito

La funzione FwpsFlowRemoveContext0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il contesto è stato rimosso correttamente dal flusso di dati.
STATUS_UNSUCCESSFUL	Al momento non è associato alcun contesto al flusso di dati.
STATUS_PENDING	È in corso una classificazione di callout attiva.
Altri codici di stato	Si è verificato un errore.

Commenti

Se la funzione FwpsFlowRemoveContext0 restituisce STATUS_SUCCESS, FwpsFlowRemoveContext0 chiama in modo sincrono la funzione callout flowDeleteFn . Se FwpsFlowRemoveContext0 restituisce STATUS_PENDING, FwpsFlowRemoveContext0 chiama flowDeleteFn in modo asincrono perché è in corso una classificazione di callout attiva.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows Vista.
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (include Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Vedi anche

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsFlowAssociateContext0

classifyFn

flowDeleteFn

Condividi tramite