imgInterfaceQueryNames

Usage

rval imgInterfaceQueryNames(uInt32 index, char* name);

Purpose

Returns the interface name identified by the index parameter. To obtain a list of all the available interface names, call this function repeatedly until the function returns an error. Make the first call with index initialized to zero. Each successive call increments the value of index by one.

Note  This function will not enumerate the individual port numbers for interfaces that support multiple ports. For example, an interface img0 that supports two ports will still be enumerated as img0. To query the number of ports that an interface supports, open port 0 of the interface and query the attribute IMG_ATTR_NUM_PORTS.

Parameters

Name	Type	Direction
index	uInt32	input
name	char*	output
rval	Int32	output

Parameter Discussion

index: interface number to obtain.

name: pointer to a character array to receive the interface name. The array must contain at least 256 elements.

Return Value

This function returns 0 on success. On failure, this function returns an error code. For information about the error code, call imgShowError.