Teledyne LeCroy SAS_SATA Automation API manual - Manual (Page 15)

Automation API for Teledyne LeCroy SAS/SATA Protocol Suite 9
SASAnalyzer Object Teledyne LeCroy
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.scs")
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;