eth32cfgiflist eth32cfg_plugin_interface_list(int *numd, int *result);
This function loads the list of available network interface cards on the PC. A plugin which provides this functionality must be loaded first before calling this function. This functionality is provided by both the System and the WinPcap plugins, but not by the None plugin. Once the function returns, details of each interface can be accessed using eth32cfg_plugin_interface_address, eth32cfg_plugin_interface_type, and eth32cfg_plugin_interface_name. Once you are done with the network interface list, the memory used by the interface list must be freed with eth32cfg_plugin_interface_list_free. This must be done before changing the plugin with eth32cfg_plugin_load.
numd - Pointer to a variable which will receive the number of network interfaces in the resulting list.
result - Pointer to a variable which will receive an error code.
The return type is defined as eth32cfgiflist, which is a handle typedef'ed as a void pointer. This function returns a nonzero handle on success, or zero on failure. However, if the function returns zero and the result code is also zero (indicating success), then it simply means that no network interfaces were found. In case of failure, the specific error code is stored into the result parameter, if provided. A valid nonzero handle can be used with other functions to obtain details about the network interfaces.
If the currently-loaded plugin does not provide this functionality, an ETH_NOT_SUPPORTED error will be stored into result, and zero will be returned.