Expand Minimize

FwpsFlowRemoveContext0 function

The FwpsFlowRemoveContext0 function removes a previously associated context from a data flow.

Note  FwpsFlowRemoveContext0 is a specific version of FwpsFlowRemoveContext. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Syntax


NTSTATUS NTAPI FwpsFlowRemoveContext0(
  _In_  UINT64 flowId,
  _In_  UINT16 layerId,
  _In_  UINT32 calloutId
);

Parameters

flowId [in]

A run-time identifier that specifies the data flow from which to remove the context. The run-time identifier for a data flow is provided to a callout driver through the FWPS_METADATA_FIELD_FLOW_HANDLE metadata value that was passed to the callout driver's classifyFn callout function.

layerId [in]

The run-time identifier for the filtering layer from which the context is being removed. For more information, see Run-time Filtering Layer Identifiers. A callout driver should specify the same identifier that it specified when it called the FwpsFlowAssociateContext0 function to associate the context with the data flow.

calloutId [in]

The run-time identifier for the callout in the filter engine. This identifier was returned when the callout driver called either the FwpsCalloutRegister0 or FwpsCalloutRegister1 functions to register the callout with the filter engine.

Return value

The FwpsFlowRemoveContext0 function returns one of the following NTSTATUS codes.

Return codeDescription
STATUS_SUCCESS

The context was successfully removed from the data flow.

STATUS_UNSUCCESSFUL

There is no context currently associated with the data flow.

Other status codes

An error occurred.

 

Remarks

If the FwpsFlowRemoveContext0 function returns STATUS_SUCCESS, FwpsFlowRemoveContext0 calls the flowDeleteFn callout function synchronously. If FwpsFlowRemoveContext0 returns STATUS_PENDING, FwpsFlowRemoveContext0 calls flowDeleteFn asynchronously because an active callout classification is in progress.

Requirements

Version

Available starting with Windows Vista.

Header

Fwpsk.h (include Fwpsk.h)

IRQL

<= DISPATCH_LEVEL

See also

classifyFn
flowDeleteFn
FwpsCalloutRegister0
FwpsCalloutRegister1
FwpsFlowAssociateContext0

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft