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

See Also

PfAddFiltersToInterface
PfRemoveFiltersFromInterface