beautypg.com

3 ianalyzer::openfile, Ianalyzer::openfile – Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 11

background image

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol
Suite

11

2.1.3 IAnalyzer::OpenFile


HRESULT OpenFile (

[in] BSTR file_name,
[out, retval] IDispatch** trace );

Opens a trace file.

Parameters


file_name

String providing the full pathname to the trace file


trace

Address of a pointer to the

UsbTrace

object primary interface

Return values

ANALYZERCOMERROR_UNABLEOPENFILE

Unable to open file.


ANALYZERCOMERROR_WRONGCALL

Error when trying to access the
opened trace when it is being
released and destroyed.

Remarks

UsbTrace

object is created via this method call, if call was successful.


In rare cases, the method may return ANALYZERCOMERROR_WRONGCALL

error. This may happen when

client code is trying to open an already opened trace file, while it is being released and destroyed.
Subsequent method calls will reopen the trace file.