PfRemoveFiltersFromInterface

  • Article

[PfRemoveFiltersFromInterface 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 PfRemoveFiltersFromInterface function removes the specified filters from the interface.

DWORD PfRemoveFiltersFromInterface(
  INTERFACE_HANDLE ih,
  DWORD cInFilters,
  PPF_FILTER_DESCRIPTOR pfiltIn,
  DWORD cOutFilters,
  PPF_FILTER_DESCRIPTOR pfiltOut
);

Parameters

  • ih
    [in] Handle to the interface.
  • cInFilters
    [in] Specifies the number of input filter descriptions pointed to by the pfiltIn parameter.
  • pfiltIn
    [in] Pointer to an array of filter descriptions to use as input filters.
  • cOutFilters
    [in] Specifies the number of output filters descriptions pointed to by the pfiltOut parameter.
  • pfiltOut
    [in] Pointer to an array of filter descriptions to use as output filters.

Return Value

If the function succeeds, the return value is NO_ERROR.

Value Meaning
PFERROR_NO_FILTERS_GIVEN No filter descriptions were supplied.
Other Use FormatMessage to obtain the message string for the returned error.

Remarks

The filter description passed in through the pfiltIn and pfiltOut parameters must be an exact match to a filter that was added previously.

No error is returned if a matching filter is not found.

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