Teledyne LeCroy UWBTracer Automation Manual - Manual (Page 53)

LeCroy UWBTracer Automation API Reference Manual Manual Version 3.02
49
4.3.2 IUwbTrace3::ExportToEthereal
HRESULT ExportToEthereal(
[in] BSTR file_name,
[in, defaultvalue(-1)] long packet_from,
[in, defaultvalue(-1)] long packet_to );
Exports trace into a text file in WireShark/Ethereal format, allowing export of a range of packets.
Parameters
file_name String providing the full pathname to the exported trace file
packet_from
Beginning packet number when you are exporting a range of packets
Value –1 means that the first packet of the exported trace is the first packet of the
trace.
packet_to
Ending packet number when you are exporting a range of packets
Value –1 means that the last packet of exported trace is the last packet of the
trace.
Return values
ANALYZERCOMERROR_UNABLESAVE Unable to export trace file
Remarks
Use this method if you want to export a recorded or opened trace into a text file in WireShark/Ethereal
format.
If this method returns an ANALYZERCOMERROR_UNABLESAVE error code, it can be because of the
following reasons:
• Wrong file path (it is not permitted to write a file to the specified location)
• WiNet feauture is not licensed (Please contact LeCroy PSG customer support for more details)
If a packet range is specified and it is invalid (for example, packet_to is more than the last packet number
in the trace, packet_from is less than the first packet number in the trace, or packet_from is more
than packet_to), then the packet range is adjusted automatically.