IPMonitor Class
Properties Methods Events Configuration Settings Errors
The IPMonitor component is used to listen to network traffic.
Class Name
IPWorks_IPMonitor
Procedural Interface
ipworks_ipmonitor_open(); ipworks_ipmonitor_close($res); ipworks_ipmonitor_register_callback($res, $id, $function); ipworks_ipmonitor_get_last_error($res); ipworks_ipmonitor_get_last_error_code($res); ipworks_ipmonitor_set($res, $id, $index, $value); ipworks_ipmonitor_get($res, $id, $index); ipworks_ipmonitor_do_config($res, $configurationstring); ipworks_ipmonitor_do_doevents($res); ipworks_ipmonitor_do_listipaddresses($res);
Remarks
The IPMonitor class will bind to a specific local host address and listen for network traffic received by the interface. The interface must support promiscuous mode (may not work in many wireless cards because of security considerations), and must be installed on Windows 2000 or greater.
NOTE: If your computer connects to a switch, the switch will only forward packets addressed to your computer. If your computer is on a hub, then you will receive everything.
The use of this component requires administrative permissions.
The first step in using the IPMonitor class is to set LocalHost to the IP address whose traffic you wish to monitor, then set Active to True. For each packet that crosses the interface, the class will parse the header and fire an IPPacket event.
Property List
The following is the full list of the properties of the class with short descriptions. Click on the links for further details.
AcceptData | Enables or disables data reception (the IPPacket event). |
Active | Enables or disables network monitoring. |
IPPacket | The contents of the current packet. |
LocalHost | The name of the local host or user-assigned IP interface through which connections are initiated or accepted. |
Method List
The following is the full list of the methods of the class with short descriptions. Click on the links for further details.
Config | Sets or retrieves a configuration setting . |
DoEvents | Processes events from the internal message queue. |
ListIPAddresses | Lists the valid IP addresses for this host. |
Event List
The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.
Error | Information about errors during data delivery. |
IPAddress | Fired for each valid IP address on this host. |
IPPacket | Fired whenever a packet is received. |
Configuration Settings
The following is a list of configuration settings for the class with short descriptions. Click on the links for further details.
ReceiveAllMode | Enables a socket to receive all IPv4 or IPv6 packets on the network. |
AbsoluteTimeout | Determines whether timeouts are inactivity timeouts or absolute timeouts. |
FirewallData | Used to send extra data to the firewall. |
InBufferSize | The size in bytes of the incoming queue of the socket. |
OutBufferSize | The size in bytes of the outgoing queue of the socket. |
CodePage | The system code page used for Unicode to Multibyte translations. |