Ivi_GetRangeTableNumEntries
Usage
ViStatus Ivi_GetRangeTableNumEntries(IviRangeTablePtr rangeTable, ViInt32* numberOfEntries);
Purpose
This function returns the number of entries in a range table, excluding the termination entry. If you pass VI_NULL for the Range Table parameter, the function returns 0 as the number of entries.
Parameters
| Name | Type | Description |
|---|---|---|
| rangeTable | IviRangeTablePtr |
Specify the address of the range table you want to examine. You can pass VI_NULL for this parameter. |
| numberOfEntries | ViInt32* |
Returns the total number of entries in the range table, excluding the termination entry. If you pass VI_NULL for the Range Table parameter, this parameter returns 0. |
Return Value
Contains the status code that the function call returns. IVI engine functions can return error and warning values from several sets of status codes. Some status codes are unique to the IVI engine. Other status codes are the same codes that VISA Library functions return. Still others are error or warning values that functions in specific instrument drivers return. Each set of status codes has its own numeric range.
Regardless of the source of the status code, 0 always indicates success, a positive value indicates a warning, and a negative value indicates an error.