FwpmFilterUnsubscribeChanges0 (Compact 7)
3/12/2014
This function is used to cancel a filter change subscription and stop receiving change notifications.
Syntax
DWORD WINAPI FwpmFilterUnsubscribeChanges0(
__in HANDLE engineHandle,
__in HANDLE changeHandle
);
Parameters
- engineHandle
A handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.
- changeHandle
Handle of the subscribed change notification. This is the handle returned by the call to FwpmFilterSubscribeChanges0.
Return Value
Return code / value | Description |
---|---|
ERROR_SUCCESS 0 |
The subscription was deleted successfully |
FWP_E_* error code 0x80320001-0x80320039 |
A Windows Filtering Platform (WFP) specific error. See topic WFP Error Codes for more information. |
RPC_* error code 0x80010001-0x80010122 |
Failure to communicate with the remote or local firewall engine |
Remarks
If the callback is currently being invoked, this function will not return until it finishes. Therefore, when you call this function, you must not hold any locks that the callback may also try to obtain for fear that you deadlock.
You do not have to unsubscribe before closing a session; all subscriptions are automatically canceled when the subscribing session ends.
This function cannot be called from inside a transaction. It will fail with FWP_E_TXN_IN_PROGRESS.
Requirements
Header |
fwpmu.h |
Library |
fwpuclnt.dll |