Edit

FwpmBfeStateUnsubscribeChanges0 function (fwpmk.h)

  • Article

The FwpmBfeStateUnsubscribeChanges0 function deregisters a base filtering engine (BFE) callback function that was previously registered by calling the FwpmBfeStateSubscribeChanges0 function.

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

Warning

Do not call FwpmBfeStateUnsubscribeChanges0 from a callback function that your driver previously registered by calling FwpmBfeStateSubscribeChanges0. Doing so can cause a deadlock.

Syntax

NTSTATUS FwpmBfeStateUnsubscribeChanges0(
  [in, out] HANDLE changeHandle
);

Parameters

[in, out] changeHandle

A handle associated with the registration of the callback function that is being deregistered. This handle was returned to the callout driver when it called the FwpmBfeStateSubscribeChanges0 function to register the callback function.

Return value

The FwpmBfeStateUnsubscribeChanges0 function returns one of the following NTSTATUS codes:

Return code Description
STATUS_SUCCESS
 The callback function was successfully deregistered.
Other status codes
 An error occurred.

Remarks

A callout driver calls the FwpmBfeStateUnsubscribeChanges0 function to deregister a callback function that was previously registered by calling the FwpmBfeStateSubscribeChanges0 function.

If a callout driver registers a callback function by calling the FwpmBfeStateSubscribeChanges0 function, it must deregister the callback function before the callout driver can be unloaded.

Requirements

Requirement Value
Minimum supported client Available starting with Windows Vista.
Target Platform Universal
Header fwpmk.h (include Fwpmk.h)
Library Fwpkclnt.lib
IRQL PASSIVE_LEVEL

See also

FwpmBfeStateSubscribeChanges0