Data Sheet

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol
Suite
12
2.1.2 IAnalyzer::GetSerialNumber
HRESULT GetSerialNumber (
[out, retval] WORD* serial_number );
Retrieves the serial number of the Analyzer device.
Parameters
Return values
ANALYZERCOMERROR_INVALIDVERSIONTYPE Specified version type is invalid.
ANALYZERCOMERROR_ANALYZERNOTCONNECTED Analyzer device is not connected.
Remarks
Example
WSH:
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Set Analyzer = WScript.CreateObject("CATC.USBTracer")
MsgBox "Serial number: " & CLng(Analyzer.GetSerialNumber())
C++:
HRESULT hr;
IUsbAnalyzer* poUsbAnalyzer;
// create UsbAnalyzer object
if ( FAILED( CoCreateInstance(
CLSID_UsbAdvisor,
NULL, CLSCTX_SERVER,
IID_IUsbAnalyzer,
(LPVOID *)&poUsbAnalyzer ) )
return;
WORD serial_number;
try
{
serial_number = poUsbAnalyzer ->GetSerialNumber();
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("UsbAnalyzer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("UsbAnalyzer client"), MB_OK );
return 1;
}
TCHAR buffer[20];
_stprintf( buffer, _T("Serial number: %X"),
HIBYTE(serial_number),
LOBYTE(serial_number) );