Manual

47
FireInspector Automation User’s Manual
CATC Version 1.0
2.4.12 ITrace::AnalyzerErrors
Retrieves trace file errors.
Syntax
HRESULT AnalyzerErrors (
[in] long error_type,
[out, retval] IAnalyzerErrors** analyzer_errors );
Parameters
long error_type
– type of error collection you want to retrieve; the following values
are valid:
• FW_BITMAP_TCODE_ERROR ( 0x00000001 )
• FW_BITMAP_DATA_CRC_ERROR ( 0x00000002 )
• FW_BITMAP_HEADER_CRC_ERROR ( 0x00000004 )
• FW_BITMAP_PHY_PKT_ERROR ( 0x00000008 )
• FW_BITMAP_DATA_LENGTH_ERROR ( 0x00000010 )
• FW_BITMAP_ACK_ERROR ( 0x00000020 )
• FW_BITMAP_RESERVED_ERROR ( 0x00000040 )
• analyzer_errors – address of a pointer to the AnalyzerErrors object primary
interface
Return values
• ANALYZERCOMERROR_INVALIDERROR – invalid error type specified
Remarks
AnalyzerErrors 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.FwAnalyzer")
Set Trace = Analyzer.MakeRecording (CurrentDir &
"Input\test_ro.rec")
Set Errors = Trace.AnalyzerErrors (16) ' Payload Length Too
Long
C++:
IFwTrace* fw_trace;
. . .
IAnalyzerErrors* analyzer_errors;
try
{
analyzer_errors =
fw_trace->AnalyzerErrors(error_type).Detach();
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("FwAnalyzer