Share via


FwpmCalloutDeleteById0 (Compact 2013)

3/26/2014

This function removes a callout object from the system.

Syntax

DWORD WINAPI FwpmCalloutDeleteById0(
  __in  HANDLE engineHandle,
  __in  UINT32 id
);

Parameters

  • engineHandle
    [in] Handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.
  • id
    [in] Runtime identifier for the callout being removed from the system. This identifier was received from the system when the application called FwpmCalloutAdd0 for this object.

Return Value

Return code / value

Description

ERROR_SUCCESS
0

The callout was successfully deleted.

FWP_E_* error code
0x80320001-0x80320039

A Windows Filtering Platform (WFP) specific error. See WFP Error Codes for details.

RPC_* error code
0x80010001-0x80010122

A Remote Procedure Call specific error. For more information see Winerror.h.

Remarks

Application callouts cannot be removed from the system if there are filters in the system that designate the callouts for an action.

This function cannot be called from within a read-only transaction. If done, an FWP_E_INCOMPATIBLE_TXN error will result. See Object Management for more information about transactions.

This function can be called within a dynamic session if the corresponding object was added during the same session. If this function is called for an object that was added during a different dynamic session, an FWP_E_WRONG_SESSION error will result. If this function is called for an object that was not added during a dynamic session, an FWP_E_DYNAMIC_SESSION_IN_PROGRESS error will result.

Requirements

Header

fwpmu.h

Library

fwpuclnt.dll

See Also

Reference

WFP Callout Management
WFP Management Functions