Returns the calibration information.
GxAoGetCalibrationInfo (nHandle, pszCalibrationInfo, nSumMaxLen, pnDaysUntilExpire, pnStatus)
Name |
Type |
Description |
nHandle |
SHORT |
Handle to a GX1649 board |
pszSummary |
PSTR |
Buffer to contain the returned board’s calibration information (null terminated) string. |
nSumMaxLen |
SHORT |
Size of the buffer to contain the error string. |
pnDaysUntilExpire |
PSHORT |
Returns the number of days until or from expiration, if number is > 0 then calibration is current otherwise past due. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The returned board’s calibration information has the following fields:
Model: model number, e.g. “GX1649”
Serial Number: serial number, e.g. 216
Control Number: Marvin Test Solutions control number, e.g. “ZZ-AD-AA-000”
Production Calibration Date: Wed Oct 24 12:30:25 2010
Calibration Date: Wed Oct 24 12:31:58 2010
Recommended Interval: 1 year
Next Calibration Date: Fri Oct 24 12:31:58 2011
Status: calibration status can be either “Expired” followed by the number of days past expiration or “Current” followed by number of days until expire.
Calibration License: can be either “Installed” with the calibration license number or “Not Installed”.
The following example returns the board’s calibration information string:
SHORT nStatus;
char szCalibrationInfo[1024];
BOOL bExpired;
GxAoGetCalibrationInfo(nHandle, szCalibrationInfo, sizeof szCalibrationInfo, &bExpired, &nStatus);
szCalibrationInfo string printout:
Model: GX1649
Serial Number: 12
Control Number: ZZ-AD-AA-000
Production Calibration Date: Wed May 23 12:30:25 2012
Calibration Date: Wed Oct 24 12:31:58 2007
Recommended Interval: 1 year
Next Calibration Date: Fri May 24 12:31:58 2013
Status: Expired (891 days past expiration)
Calibration License: Installed license number 3