Type a page name and press Enter. You'll jump to the page if it exists, or you can create it if it doesn't.
To create a page in a module other than iphlpapi, prefix the name with the module name and a period.
PfCreateInterface (iphlpapi)
.
C# Signature:
[DllImport("Iphlpapi.dll", EntryPoint = "PfCreateInterface")]
static extern Int32 PfCreateInterface(int dwName, uint inAction, uint outAction, int bUseLog, int bMustBeUnique, ref IntPtr ppInterface);
VB Signature:
Declare Function PfCreateInterface Lib "iphlpapi.dll" (TODO) As TODO
User-Defined Types:
None.
Notes:
/// <summary>
/// The PfCreateInterface function creates a new filter interface. Use this interface to control the adding and deleting of filters to and from adapters.
/// </summary>
/// <param name="dwName">[in] Specifies the interface name. A zero value specifies a new, unique interface. Any other value is a potentially shared interface.
/// The bMustBeUnique parameter can turn a shared interface into a unique one. However, using bMustBeUnique in this way can cause the function to fail.</param>
/// <param name="inAction">[in] Specifies a default action for an input packet. This member can be one of the following values.</param>
/// <param name="outAction">[in] Specifies a default action for an output packet. This member can be one of the following values.</param>
/// <param name="bUseLog">[in] Specifies whether to bind the log to this interface. If this member is TRUE, the log is bound to this interface.</param>
/// <param name="bMustBeUnique">[in] Specifies whether the interface is unique or shared. If this member is TRUE, this interface is unique, that is, it cannot be shared.</param>
/// <param name="ppInterface">[out] Pointer to a pointer that, on successful return, points to an interface handle to use with subsequent function calls.</param>
/// <returns>If the function succeeds, the return value is NO_ERROR.</returns>
Alternative Managed API:
Do you know one? Please contribute it!
Sample Code:
Notes:
using System;
using System.Collections.Generic;
using System.Net;
using System.Runtime.InteropServices;
using Microsoft.Win32;
Tips & Tricks:
Please add some!
/// <summary>
/// IP packet filter management wrapper for Iphlpapi.dll (Win 2000/XP)
/// </summary>
class Program
{
// C conversions for Fltdefs.h
internal const int FALSE = 0;
internal const int TRUE = 1;
internal enum PFADDRESSTYPE : uint
{
PF_IPV4,
PF_IPV6
}
using System;
using System.Collections.Generic;
using System.Net;
using System.Runtime.InteropServices;
using Microsoft.Win32;
internal enum PROTOCOL : uint
/// <summary>
/// IP packet filter management wrapper for Iphlpapi.dll (Win 2000/XP)
/// </summary>
class Program
{
// C conversions for Fltdefs.h
internal const int FALSE = 0;
internal const int TRUE = 1;
[StructLayout(LayoutKind.Sequential, Pack = 1)]
internal unsafe struct PPF_FILTER_DESCRIPTOR
internal enum PROTOCOL : uint
{
public FILTER_FLAGS dwFilterFlags;
public UInt32 dwRule;
public PFADDRESSTYPE pfatType;
public UInt32* SrcAddr;
public UInt32* SrcMask;
public UInt32* DstAddr;
public UInt32* DstMask;
public PROTOCOL dwProtocol;
public UInt32 fLateBound;
public UInt16 wSrcPort;
public UInt16 wDstPort;
public UInt16 wSrcPortHighRange;
public UInt16 wDstPortHighRange;
ANY = 0x00,
ICMP = 0x01,
TCP = 0x06,
UDP = 0x11
}
static void Main(string[] args)
internal enum FILTER_FLAGS : uint
{
string[] hostsToBlock = new string[2];
hostsToBlock[0] = "67.77.87.97,255.255.255.255,0"; //blocks all traffic on any port to/from 67.77.87.97
hostsToBlock[1] = "0.0.0.0,0.0.0.0,29000"; //blocks all traffic on port 29000, in and out
StartPacketFilter(hostsToBlock);
System.Windows.Forms.Application.Run();
FD_FLAGS = 0x1
}
if (octets.Length != 4)
return 0;
public UInt32* SrcAddr;
public UInt32* SrcMask;
public UInt32* DstAddr;
public UInt32* DstMask;
for (int i = 0; i < 4; i++)
lIp |= (UInt32.Parse(octets[i]) << (i * 8));
}
catch { }
return lIp;
public PROTOCOL dwProtocol;
public UInt32 fLateBound;
public UInt16 wSrcPort;
public UInt16 wDstPort;
public UInt16 wSrcPortHighRange;
public UInt16 wDstPortHighRange;
}
internal static string[] GetLocalIpAddresses()
static void Main(string[] args)
{
IPHostEntry host = Dns.GetHostEntry(Dns.GetHostName());
string[] localIpAddresses = new string[host.AddressList.Length];
for (int i = 0; i < host.AddressList.Length; i++)
{
localIpAddresses[i] = host.AddressList[i].ToString();
}
return localIpAddresses;
string[] hostsToBlock = new string[2];
hostsToBlock[0] = "67.77.87.97,255.255.255.255,0"; //blocks all traffic on any port to/from 67.77.87.97
hostsToBlock[1] = "0.0.0.0,0.0.0.0,29000"; //blocks all traffic on port 29000, in and out
StartPacketFilter(hostsToBlock);
System.Windows.Forms.Application.Run();
}
uint iDstAddr = lIpFromString(hostDetail[0]);
uint iDstMask = lIpFromString(hostDetail[1]);
filter.wDstPort = UInt16.Parse(hostDetail[2]);
filter.wDstPortHighRange = UInt16.Parse(hostDetail[2]);
//convert the string IP to an unsigned int for p/invoke
UInt32 lLocalIp = lIpFromString(localAddress);
unsafe
{
filter.SrcAddr = &iSrcAddr;
filter.DstAddr = &iDstAddr;
filter.SrcMask = &iSrcMask;
filter.DstMask = &iDstMask;
}
// add filter to interface (both inbound and outbound)
result = IpPacketFilter.PfAddFiltersToInterface(interfaceHandle, 1, ref filter, 1, ref filter, filterHandle);
if (result != 0)
return false;
}
}
}
return true;
}
}
//create a filter interface in the tcp/ip stack
result = IpPacketFilter.PfCreateInterface(0, PFFORWARD_ACTION.PF_ACTION_FORWARD, PFFORWARD_ACTION.PF_ACTION_FORWARD, FALSE, TRUE, ref interfaceHandle);
if (result != 0)
return false;
//bind interface to an ip address
result = IpPacketFilter.PfBindInterfaceToIPAddress(interfaceHandle, PFADDRESSTYPE.PF_IPV4, ref lLocalIp);
if (result != 0)
return false;
foreach (string targetHost in hosts)
{
IntPtr filterHandle = new IntPtr();
string[] hostDetail = targetHost.Split(new string[] { "," }, StringSplitOptions.None);
if (hostDetail != null && hostDetail.Length == 3)
{
//build the filter structure
PPF_FILTER_DESCRIPTOR filter = new PPF_FILTER_DESCRIPTOR();
filter.dwFilterFlags = FILTER_FLAGS.FD_FLAGS;
filter.dwRule = FALSE;
filter.pfatType = PFADDRESSTYPE.PF_IPV4;
filter.dwProtocol = PROTOCOL.TCP;
The PfCreateInterface function creates a new filter interface. Use this interface to control the adding and deleting of filters to and from network adapters.
3/23/2010 11:01:43 AM - Rob Kaczor-153.2.246.30
Please edit this page!
Do you have...
helpful tips or sample code to share for using this API in managed code?
corrections to the existing content?
variations of the signature you want to share?
additional languages you want to include?
Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).