beautypg.com

1 iuwbverificationscript::runverificationscript, Iuwbverificationscript::runverificationscript – Teledyne LeCroy UWBTracer Automation Manual User Manual

Page 55

background image

LeCroy

UWBTracer Automation API Reference Manual

Manual Version 3.02

51

4.4.1 IUwbVerificationScript::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 a enumeration type that can have 3 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
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.