User manual

2.3.52 AcqrsD1_errorMessageEx
Purpose
Translates an error code into a human readable form and returns associated information. The new function
Acqrs_errorMessage is to be preferred.
Parameters
Input
Name Type Description
instrumentID ViSession Instrument identifier can be VI_NULL
errorCode ViStatus Error code (returned by a function) to be translated
errorMessageSize ViInt32 Size of the errorMessage string in bytes
(suggested size 512)
Output
Name Type Description
errorMessage ViChar [ ] Pointer to user-allocated string (suggested size 512)
into which the error-message text is returned
Return Value
Name Type Description
status ViStatus Refer to Table 2-1 for error codes.
Discussion
This function should be called immediately after the return of the error status to ensure that the additional
information remains available. For file errors, the returned message will contain the file name and the
original 'ansi' error string. This is particularly useful for calls to the following functions:
Acqrs_calibrate Acqrs_calibrateEx
Acqrs_configLogicDevice AcqrsD1_configMode
Acqrs_init Acqrs_InitWithOptions
Programmer’s Reference Manual Page 102 of 210