Teledyne LeCroy UWBTracer Automation Manual - Manual (Page 33)

LeCroy UWBTracer Automation API Reference Manual Manual Version 3.02
29
4.1.1 IUwbTrace::GetName
HRESULT GetName (
[out, retval] BSTR* trace_name );
Retrieves 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.UwbAnalyzer")
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Analyzer.StartRecording (CurrentDir & "test_ro.rec")
'... do something
Set Trace = Analyzer.StopRecordingAndWaitForTrace
MsgBox “Trace name “ & Trace.GetName
C++:
IUwbTrace*
UWB_trace;
. . .
_bstr_t bstr_trace_name;
try
{
bstr_trace_name = UWB_trace->GetName();
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("UwbAnalyzer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("UwbAnalyzer 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 );