Share via


PfRemoveFilterHandles

[PfRemoveFilterHandles is available for use in the operating systems listed in the Requirements section. In Windows Server "Longhorn", this function returns ERROR_CALL_NOT_SUPPORTED. The MprConfigInterfaceTransportSetInfo function and the Windows Filtering Platform API Management Functions provide similar functionality.]

The PfRemoveFilterHandles function removes the filter associated with the specified handles.

DWORD PfRemoveFilterHandles(
  INTERFACE_HANDLE pInterface,
  DWORD cFilters,
  PFILTER_HANDLE pvHandles
);

Parameters

  • pInterface
    [in] Specifies a handle to the interface.
  • cFilters
    [in] Specifies the number of filter handles pointed to by the pvHandles parameter. Obtain these handles from the PfAddFiltersToInterface function.
  • pvHandles
    [in] Pointer to an array of filter handles that specify the filters to remove.

Return Value

If the function succeeds, the return value is NO_ERROR.

If the function fails, use FormatMessage to obtain the message string for the returned error.

Requirements

Server Requires Windows Server 2003 or Windows 2000 Server.
Header

Declared in Fltdefs.h.

Library

Use Iphlpapi.lib.

DLL Requires Iphlpapi.dll.

See Also

PfAddFiltersToInterface
PfRemoveFiltersFromInterface