Teledyne LeCroy SAS_SATA Tracer_Trainer Automation API Manual - Manual (Page 45)

LeCroy Corporation Automation API for SAS/SATATracer/Trainer Manual Version 1.11
45
4.3.1 ISASVerificationScript::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, SASTracer’s server
searches for the named script among the scripts loaded from the \Scripts\VFScripts
folder under the SASTracer 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
SASTracer Verification Script Engine Manual for more details.