GPIB__GetNextInstrument (ul_pbar_gpib)

 *  Synopsis:
 *    #include <ul_pbar_gpib:gpibdir.h>
 *
 *    int GPIB__GetNextInstrument( const char *instrumentType,
 *                                 char *name, int *index,
 *                                 const int nullTerminate )
 *
 *  Function intent:
 *    GPIB__GetNextInstrument() returns the name string and instrument index
 *    for the next instrument of the specified type as found in the instrument
 *    directory.  If the nullTerminate parameter is TRUE then the routine will
 *    null terminate the returned name string.  In this event the caller is
 *    responsible for providing at least a 21 character buffer.
 *  Function parameters:
 *    instrumentType	instrument type code string (e.g., NA, SA, OS, VM)
 *                        Use "**" to match any instrument type
 *                        (KTYPE_LENGTH characters)
 *    name		returned instrument name (KNAME_LENGTH characters)
 *    index		returned instrument index used in calls
 *                      to GPIB__GetInstrumentInfo()
 *    nullTerminate	NULL terminate name string:
 *                      TRUE = terminate, FALSE = don't terminate
 *  Function return value:
 *    CLIB_OK		success
 *    CBS_INVARG	illegal instrument type
 *    CLIB_NO_SUCH	instrument type not found in directory