beautypg.com

2 ianalyzer::getserialnumber, Ianalyzer::getserialnumber – Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 10

background image

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol
Suite

10

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: " & 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) );