Agilent Technologies E1439, User Manual

Page: 113 / 246

103
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_error_query
Queries the module for the first error in the queue.
VXI plug&play Syntax
#include "age1439".h
ViStatus age1439_error_query(ViSession id , ViPint32 errorCode , ViChar errorMessage[] );
Description
age1439_error_query queries the module for the oldest error and returns the corresponding error
message. This function does not report host errors that originate in the C library.
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
errorCode points to the instrument numeric error code.
errorMessage points to the error message string up to 80 characters long. This message also indicates what
function call generated the error.
Note
For this parameter you must allocate a character array of at least 256 characters AGE1439_STR_
LEN_MIN , including the null byte, prior to calling this function in any programming language.
Return Value
AGE1439_SUCCESS indicates that a function was successful.
Values other than AGE1439_SUCCESS indicate an error condition or other important status
condition. To determine the error message, pass the return value to “age1439_error_message” on
page 102 .
See Also
“age1439_init” on page 132 , “age1439_error_message” on page 102