Load Method

static void Load(Eth32ConfigPluginType plugin_type)

Summary

This method loads one of the pre-defined plugins. The currently-loaded plugin affects the entire process in terms of the Configuration and Detection functionality (the Eth32Config class), but does not affect the main functionality of the API (the Eth32 class). See the Plugins topic for more information.

Parameters

  • plugin_type - The plugin to be loaded. This can be one of the following options:

    • Eth32ConfigPluginType.None - No plugin loaded. This is the default if Load is never called. If another plugin is loaded, calling Load with this option will remove the loaded plugin.

    • Eth32ConfigPluginType.System - The Windows API is used to provide information about the network interfaces on the PC. Using this plugin does not affect how queries are sent out or how responses are received.

    • Eth32ConfigPluginType.Pcap - The WinPcap library is used to provide information about the network interfaces as well as to sniff for ETH32 responses on the chosen interface.

Return Value

This method does not return a value.

Remarks

If a plugin is attempted to be loaded that is not present on the system, an EthError.NotSupported error will be raised.

When one plugin (other than None) has been loaded and Eth32ConfigPlugin object(s) with interface list(s) are open, you must make sure that the Free Method of each Eth32ConfigPlugin object is called before changing the plugin with this method. This is due to the fact that the loaded plugin affects the entire process (note that this method is static), so it is up to you as the programmer to ensure that any active Eth32ConfigPlugin objects are Free'd before changing the plugin.

See Also

Free Method