AddToRepCapTable

IVI Library

Ivi_AddToRepCapTable

Usage

ViStatus Ivi_AddToRepCapTable(ViSession vi, ViChar repeatedCapabilityName[ ], ViChar Identifiers[ ]);

Purpose

This function adds additional repeated capability identifiers to the repeated capability table you establish with Ivi_BuildRepCapTable.

Parameters

Name Type Description
vi ViSession

The ViSession handle that you obtain from Ivi_SpecificDriverNew. The handle identifies a particular IVI session.

repeatedCapabilityName ViChar[ ]

Pass a string containing the name of the repeated capability on which to operate. For instance, if you are working with the table of channel names, pass in the string "Channel".

Identifiers ViChar[ ]

Pass a string containing a list of additional repeated capability identifiers you want to add to the repeated capability table. You must separate repeated capability identifiers with commas. You can include spaces after the commas.

For example, to add "3" and "4" as valid identifiers for the repeated capability, pass "3, 4".

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.

Related Topic

IVI Status Codes