FwpmBfeStateUnsubscribeChanges0 function

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.

Syntax

NTSTATUS NTAPI FwpmBfeStateUnsubscribeChanges0(
  _Inout_ HANDLE changeHandle
);

Parameters

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.

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

Requirements

   
Windows version Available starting with Windows Vista.
Target Platform Universal
Header fwpmk.h (include Fwpmk.h)
Library Fwpkclnt.lib
IRQL PASSIVE_LEVEL

See Also

FwpmBfeStateSubscribeChanges0

Send comments about this topic to Microsoft