GPIB__RequestString (ul_pbar_gpib)
* Synopsis:
* #include <ul_pbar_gpib:gpib.h>
*
* int GPIB__RequestString( const CGPIBptr modulePtr, const char *command,
* char *response, const int maxLenght )
*
* Function intent:
* GPIB__RequestString() selects the specified GPIB module if not currently
* selected, sends the provided request, and reads and returns the resulting
* response string. If the response string contains an LF or CR immediatly
* preceeding the terminating '\0' it is replaced with a '\0'.
* Function parameters:
* CGPIBptr modulePtr The unique GPIB module I/O control pointer
* returned by GPIB__InitializeModule().
* char *command The null terminated command string to be sent
* char *response The destination data array
* int maxLenght The largest data count expected. If the
* actual response is shorter than maxLenght it
* will be null terminated.
* Function return value:
* CBS_OK command successfully written
* CLIB_NO_SUCH invalid reference number
* CBS_INVARG invalid GPIB address
* no such module type for the given front end
* or invalid module pointer
* CBS_NODAT VME interface device could not be retrieved
* for this GPIB address
* CBS_NO_SUCH VME interface device doesn't exist
* DIO_xxx error retrieving VME interface device
* otherwise GAS error