beautypg.com

1 itrace::getname, Itrace::getname – Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 43

background image

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

43

3.1.1 ITrace::GetName


HRESULT GetName (

[out, retval] BSTR* trace_name );

Retrieves the trace name.

Parameters


trace_name

Name of the trace

Return values


Remarks

This name can be used for presentation purposes.
Do not forget to free the string returned by this method call.

Example


WSH:

Set Analyzer = WScript.CreateObject("CATC.USBTracer")
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Set Trace = Analyzer.MakeRecording (CurrentDir & "Input\test_ro.rec")
MsgBox "Trace name " & Trace.GetName


C++:

IUsbTrace* usb_trace;


. . .

_bstr_t bstr_trace_name;
try

{

bstr_trace_name = usb_trace->GetName();

}
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 str_trace_name[256];
_tcscpy( str_trace_name, (TCHAR*)( bstr_trace_name) );
SysFreeString( bstr_trace_name );

::MessageBox( NULL, str_trace_name, _T("Trace name"), MB_OK );