Teledyne LeCroy SierraFC Automation API - Manual (Page 18)

LeCroy Corporation SierraFC M8-4 API Reference Manual Manual Version 1.00
18
3.1.7 IFCAnalyzer::GetRecordingOptions
HRESULT GetRecordingOptions (
[out, retval] IDispatch** recording_options );
Retrieves the interface for access to the recording options.
Parameters
recording_options Address of a pointer to the FCRecOptions object interface
Return values
Remarks
The FCRecOptions object is created via this method call, if the call was successful.
Example
WSH:
Set Analyzer = WScript.CreateObject("Lecroy.FCAnalyzer")
Set RecOptions = Analyzer.GetRecordingOptions
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* rec_opt;
try
{
rec_opt = poFCAnalyzer->GetRecordingOptions();
}
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
IFCRecOptions* ib_rec_opt;
hr = rec_opt->QueryInterface( IID_IFCRecOptions, (LPVOID *)&ib_rec_opt );
rec_opt->Release();
if( FAILED(hr) )
return;