Teledyne LeCroy SierraFC Automation API - Manual (Page 41)

LeCroy Corporation SierraFC M8-4 API Reference Manual Manual Version 1.00
41
4.3.1 IFCVerificationScript::RunVerificationScript
HRESULT RunVerificationScript (
[in] BSTR verification_script,
[out, retval] VSResult *result )
Runs a verification script over the recorded trace.
Parameters
verification_script
Name of the verification script to run
result Address of a variable in which to keep the verification result
VS_RESULT is an enumeration type that can have five meanings:
SCRIPT_RUNNING (-2) - verification script is running
SCRIPT_NOT_FOUND (-1) - verification script with the specified name not found
FAILED ( 0) - verification failed
PASSED ( 1) - verification passed
DONE ( 2) - verification is done, do not 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 (*.pevs). If
only the name of the script, without file extension, is specified, SierraFC Protocol
Analyzer’s server searches for the named script among the scripts loaded from the
\Scripts\VFScripts folder under the SierraFC M8-4 and SierraFC M164 installation
folder. If the full path to the script is specified, then the server attempts to load the script
from the specified path prior to running it.
Example
For a verification script file named test.pevs, the test name is
―test‖. Please refer to the
SierraFC M8-4 Verification Script Engine Manual for more details.