Teledyne LeCroy SierraFC Automation API - Manual (Page 11)

LeCroy Corporation SierraFC M8-4 API Reference Manual Manual Version 1.00
11
3.1.2 IFCAnalyzer::OpenFile
HRESULT OpenFile (
[in] BSTR file_name,
[out, retval] IDispatch** trace );
Opens trace file and creates the FCTrace object.
Parameters
file_name
String providing the full pathname to the trace file
trace
Address of a pointer to the FCTrace object interface
Return values
ANALYZERCOMERROR_UNABLEOPENFILE – unable to open file
Remarks
FCTrace object is created via this method call, if call was successful.
Example
WSH:
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Set Analyzer = WScript.CreateObject("Lecroy.FCAnalyzer ")
Set Trace = Analyzer.OpenFile (CurrentDir & "Input\errors.sat")
C++:
HRESULT hr;
IFCAnalyzer* poFCAnalyzer;
// create FCAnalyzer object
if ( FAILED( CoCreateInstance(
CLSID_FCAnalyzer,
NULL, CLSCTX_SERVER,
IID_IFCAnalyzer,
(LPVOID *)&poFCAnalyzer ) )
return;
// Open trace file.
IDispatch* trace;
try
{
trace = poFCAnalyzer->OpenFile( m_szRecFileName );
}
catch (_com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("SierraFC M8-4 client"), MB_OK
);
else
::MessageBox( NULL, er.ErrorMessage(), _T("SierraFC M8-4 client"), MB_OK
);
return 1;
}
// query for VTBL interface
IFCTrace* FC_trace;
hr = trace->QueryInterface( IID_IFCTrace, (LPVOID *)&FC_trace );
trace->Release();
if( FAILED(hr) )
return;