Racal Instruments 3156B, Руководство пользователя

Страница: 326 / 385

3156B User Manual
Programming Reference 5-174 Racal Instrument © 2005
Ri3156b_error_message
Description
This Converts a numeric error code returned by one of the functions of this driver into a descriptive error
message string.
Channel Dependency: Common
C Syntax
ViStatus ri3156b_error_message (ViSession instrHandle, ViStatus * errorReturnValue, ViChar * errorMessage)
Parameters
Name
Variable
Type
Description
instrHandle ViSession The Instrument Handle is used to identify the unique
session or communication channel between the driver
and the instrument. If more than one instrument of the
model type is used, this will be used to differentiate
between them. Note that the initialize function may be
used to associate multiple instrument handles with a
single instrument.
errorReturnValue ViStatus Accepts the error codes which were returned by one of
the functions in this instrument driver.
errorMessage ViChar[] This holds a string upon return from the function which is
associated with the error number.
Return Values
Displays the return status of the function call. If the function was successful, it will return a status of
VI_SUCCESS, otherwise it will return an error code. Passing the error code into the function
"ri3156B_error_message()" will return a string describing the error.
Ri3156b_read_serial_number
Description
This reads the serial number of the instrument as was assigned by the factory. The returned value must match
the number printed on the serial number label on the side panel of the 3156B.
Channel Dependency: Common
C Syntax
ViStatus ri3156b_read_serial_number (ViSession instrHandle, ViChar * serialNumber)