PfAddGlobalFilterToInterface

  • Article

[PfAddGlobalFilterToInterface 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 PfAddGlobalFilterToInterface function adds a global filter on the specified interface.

DWORD PfAddGlobalFilterToInterface(
  INTERFACE_HANDLE pInterface,
  GLOBAL_FILTER gfFilter
);

Parameters

  • pInterface
    [in] Handle to the interface.
  • gfFilter
    [in] Specifies the global filter to add to the interface.

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.

Remarks

The global filter acts across all filters on the interface.

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

FormatMessage
GLOBAL_FILTER
PfRemoveGlobalFilterFromInterface