Teledyne LeCroy SAS_SATA Tracer_Trainer Automation API Manual - Manual (Page 11)

LeCroy Corporation Automation API for SAS/SATATracer/Trainer Manual Version 1.11
11
3.1.2 ISASAnalyzer::OpenFile
HRESULT OpenFile (
[in] BSTR file_name,
[out, retval] IDispatch** trace );
Opens trace file and creates the SASTrace object.
Parameters
file_name
String providing the full pathname to the trace file
trace
Address of a pointer to the SASTrace object interface
Return values
ANALYZERCOMERROR_UNABLEOPENFILE – unable to open file
Remarks
SASTrace 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.SASAnalyzer ")
Set Trace = Analyzer.OpenFile (CurrentDir & "Input\errors.sat")
C++:
HRESULT hr;
ISASAnalyzer* poSASAnalyzer;
// create SASAnalyzer object
if ( FAILED( CoCreateInstance(
CLSID_SASAnalyzer,
NULL, CLSCTX_SERVER,
IID_ISASAnalyzer,
(LPVOID *)&poSASAnalyzer ) )
return;
// Open trace file.
IDispatch* trace;
try
{
trace = poSASAnalyzer->OpenFile( m_szRecFileName );
}
catch (_com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("SASTracer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("SASTracer client"), MB_OK );
return 1;
}
// query for VTBL interface
ISASTrace* SAS_trace;
hr = trace->QueryInterface( IID_ISASTrace, (LPVOID *)&SAS_trace );
trace->Release();
if( FAILED(hr) )
return;