int eth32cfg_plugin_interface_name(eth32cfgiflist handle, int index, int nametype, char *name, int *length);
This function retrieves name and description information about one of the interfaces in the network interface list that was previously obtained by calling eth32cfg_plugin_interface_list. Depending on the plugin that is currently loaded, each interface may have several types of names available. This function needs to be called separately for each type of name you want to retrieve.
handle - The value returned by eth32cfg_plugin_interface_list
index - The index of the interface within the list
nametype - This can be one of the following values:
ETH32CFG_IFACENAME_STANDARD - Retrieves a string which is typically an internal identifier string for the interface, but is not very human-readable. The exact value depends on the plugin being used. This string will be available when using the System plugin or when using the WinPcap plugin.
ETH32CFG_IFACENAME_FRIENDLY - Retrieves the human-readable name for the interface. For example, Local Area Connection. The ETH_NOT_SUPPORTED error will be returned if the WinPcap plugin is loaded.
ETH32CFG_IFACENAME_DESCRIPTION - Retrieves a description of the interface. The value of the string depends on the plugin being used, but typically includes the manufacturer or model of the card. The string will be available when using the System plugin or when using the WinPcap plugin.
name - Pointer to string buffer where the requested name/description should be stored
length - Pointer to variable containing the length of the name buffer. You must store the buffer length to this variable before calling this function. If the buffer is not large enough and the function returns ETH_BUFSIZE, then the function will also store the required buffer length into this variable.
This function returns zero on success and a negative error code on failure. Please see the Error Codes section for possible error codes.
The index is zero-based, which means it can range from zero up to one less than the number of available interfaces.