IPMonitor Configuration

The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

IPMonitor Configuration Settings

ListInterface: Lists the interfaces visible to the WinPCap or NPCap driver.

Returns a numbered list of interfaces visible to the WinPCap or NPCap driver on the system.

ReceiveAllMode: Enables a socket to receive all IPv4 or IPv6 packets on the network.

Available modes:


Value	Description
0	Do not receive all network traffic.
1 (default)	Receive all network traffic. This enables promiscuous mode on the network interface card (NIC). On a LAN segment with a network hub, a NIC that supports promiscuous mode will capture all IPv4 or IPv6 traffic on the LAN, including traffic between other computers on the same LAN segment.
2	Receive only socket-level network traffic (Feature may not be implemented by your Windows installation).
3	Receive only IP level network traffic. This option does not enable promiscuous mode on the network interface card. This option only affects packet processing at the IP level. The NIC still receives only packets directed to its configured unicast and multicast addresses. However, a socket with this option enabled will receive not only packets directed to specific IP addresses, but will receive all the IPv4 or IPv6 packets the NIC receives.

ReceiveAllMode captures only IPv4 and IPv6 packets. It will not capture other packets (ARP, IPX, NetBEUI packets, for example) on the interface.

SelectedInterface: Used to select the interface the WinPCap or NPCap driver will listen on.

Set this to the index of the interface the WinPCap or NPCap driver will listen on. Indices can be returned by querying ListInterface.

UseWinPCap: Whether to use the WinPCap or NPCap driver.

When set to true the component will use the WinPCap or NPCap driver available on the system. The default is false.

Socket Configuration Settings


	AbsoluteTimeout: Determines whether timeouts are inactivity timeouts or absolute timeouts. If AbsoluteTimeout is set to True, any method which does not complete within Timeout seconds will be aborted. By default, `AbsoluteTimeout` is False, and the timeout is an inactivity timeout. Note: This option is not valid for UDP ports.
	FirewallData: Used to send extra data to the firewall. When the firewall is a tunneling proxy, use this property to send custom (additional) headers to the firewall (e.g. headers for custom authentication schemes).
	InBufferSize: The size in bytes of the incoming queue of the socket. This is the size of an internal queue in the TCP/IP stack. You can increase or decrease its size depending on the amount of data that you will be receiving. Increasing the value of the `InBufferSize` setting can provide significant improvements in performance in some cases. Some TCP/IP implementations do not support variable buffer sizes. If that is the case, when the component is activated the `InBufferSize` reverts to its defined size. The same happens if you attempt to make it too large or too small.
	OutBufferSize: The size in bytes of the outgoing queue of the socket. This is the size of an internal queue in the TCP/IP stack. You can increase or decrease its size depending on the amount of data that you will be sending. Increasing the value of the `OutBufferSize` setting can provide significant improvements in performance in some cases. Some TCP/IP implementations do not support variable buffer sizes. If that is the case, when the component is activated the `OutBufferSize` reverts to its defined size. The same happens if you attempt to make it too large or too small.

Base Configuration Settings


	BuildInfo: Information about the product's build. When queried, this setting will return a string containing information about the product's build.
	GUIAvailable: Tells the component whether or not a message loop is available for processing events. In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation. In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GUIAvailable to false will ensure that the component does not attempt to process external events.
	LicenseInfo: Information about the current license. When queried, this setting will return a string containing information about the license this instance of a component is using. It will return the following information: Product: The product the license is for. Product Key: The key the license was generated from. License Source: Where the license was found (e.g. RuntimeLicense, License File). License Type: The type of license installed (e.g. Royalty Free, Single Server).
	UseInternalSecurityAPI: Tells the component whether or not to use the system security libraries or an internal implementation. By default the component will use the system security libraries to perform cryptographic functions. When set to False calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security implementation set this setting to True. Setting this to True tells the component to use the internal implementation instead of using the system's security API. Note: This setting is static. The value set is applicable to all components used in the application. When this value is set the product's system DLL is no longer required as a reference, as all unmanaged code is stored in that file.

IPWorks 2020 .NET Edition

IPMonitor Configuration