Teledyne LeCroy SAS_SATA Automation API manual - Manual (Page 87)

Automation API for Teledyne LeCroy SAS/SATA Protocol Suite 81
SASTrace Object Teledyne LeCroy
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 Value
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 script name, without file extension, is specified, the Sierra/STX server searches
for the named script among the scripts loaded from the \Scripts\VFScripts folder under
the SAS/SATA Protocol Suite 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.
Example
C++:
// This example uses wrapper functions provided by the
#import directive.
ISASTrace* trace;
. . .
ISASVerificationScript* vscript = NULL;