Teledyne LeCroy Automation API for Bluetooth Analyzers - Manual (Page 18)

12
Automation API for CATC Bluetooth Analyzers CATC Ver. 1.40
2.3.4 IAnalyzer::OpenFile
Opens trace file
Parameters
file_name - string providing the full pathname to trace file
trace - address of a pointer to the BTTrace object primary interface
Return values
ANALYZERCOMERROR_UNABLEOPENFILE – unable to open file
Remarks
BTTrace object is created via this method call, if call was successful.
Example
WSH:
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName,
"\"))
Set Analyzer = WScript.CreateObject("CATC.Merlin")
Set Trace = Analyzer.OpenFile (CurrentDir & "Input\errors.blt")
C++:
HRESULT hr;
IBTAnalyzer* poBTAnalyzer;
// create BTAnalyzer object
if ( FAILED( CoCreateInstance(
CLSID_BTAnalyzer,
NULL, CLSCTX_SERVER,
IID_IBTAnalyzer,
(LPVOID *)&poBTAnalyzer ) )
return;
// open trace file
IDispatch* trace;
try
{
trace = poBTAnalyzer->OpenFile( m_szRecFileName );
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("BTAnalyzer client"),
MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("BTAnalyzer client"),
MB_OK );
return 1;
}
// query for VTBL interface
IBTTrace* bt_trace;
hr = trace->QueryInterface( IID_IBTTrace, (LPVOID *)&bt_trace );
trace->Release();
if( FAILED(hr) )
return;
HRESULT OpenFile (
[in] BSTR file_name,
[out, retval] IDispatch** trace );