Agilent Technologies VXI E1439 - Manual (Page 182)

172
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_serial_number
Sets the serial number of the module. This description also includes the query function:
age1439_serial_number_get
VXIplug&play Syntax
#include "age1439".h
ViStatus age1439_serial_number(ViSession id, ViChar serialNum[]);
ViStatus age1439_serial_number_get(ViSession id, ViChar serialNum[]);
Caution
This command is to be used for repair purposes only.
Description
This command is used to reassign a serial number after a module has been serviced.
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
serialNum sends or gets a serial number of less than 16 characters
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