beautypg.com

1 iusbverificationscript::runverificationscript, Iusbverificationscript::runverificationscript – Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 71

background image

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

71

3.6.1 IUsbVerificationScript::RunVerificationScript

HRESULT RunVerificationScript ( [in] BSTR verification_script,
[out, retval] VS_RESULT *pResult);

Runs verification script over the recorded trace.

Parameters


verification_script

Name or full path of the verification script to run

pResult

Address of a variable in which to keep the result of
verification


VS_RESULT is an enumeration type that can have these possible meanings:

enum VS_RESULT
{
SCRIPT_RUNNING = -2, // Verification script is running.
SCRIPT_NOT_FOUND = -1, // Verification script with the specified name was
// not found.
FAILED

= 0, // Verification failed.

PASSED

= 1, // Verification passed.

DONE = 2 // Verification is done, don’t care about result.
};

Return values

S_OK

If the verification script executed successfully.

Remarks

The name of the verification script is the name of the verification script file (*.vse) without the file
extension. For example, for verification script file test.vse, the test name is test. Please refer to the
Teledyne LeCroy UWB Script Verification Engine Manual for details.

If a full path is specified (such as C:\test.vse), VSE uses it, instead of searching for the script by name in
the \Scripts\VFScripts application subfolder.