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

LeCroy Corporation Automation API for SAS/SATATracer/Trainer Manual Version 1.11
75
8.1.4 IVScriptEngine::RunVScriptEx
HRESULT RunVScriptEx (
[in] BSTR script_name,
[out, retval] int* pResult )
Changes the current verification script name and runs the verification script.
Parameters
script_name Name of the verification script to initialize the script verification engine
pResult Address of the variable where the results of the verification are kept
Return values
Remarks
This method makes a “synchronous” call, which means that this method does not
return until the script stops running.
The name of the verification script is the name of the verification script file (*.pevs). If
only the name of the script, without a file extension, is specified, the SASTracer 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.
See ISASVerificationScript:: RunVerificationScript method for details.
Example
C++:
// In this example, we use wrapper functions provided by the #import directive.
ISASTrace* sas_trace;
. . .
ISASVerificationScript* sas_vscript = NULL;
sas_trace->QueryInterface( IID_ISASVerificationScript, (void**)&sas_vscript ) )
assert( sas_vscript != NULL );
IVScriptEngine* sas_vsengine = NULL;
sas_vsengine = sas_vscript -> GetVScriptEngine("Test_1");
assert( sas_vsengine != NULL );
VS_RESULT result = sas_vsengine ->RunVScript();
if( result == PASSED )
{
::MessageBox( NULL, "Test 1 passed !!!", "SASTracer client", MB_OK );
}
result = sas_vsengine ->RunVScriptEx("Test_2");
if( result == PASSED )
{
::MessageBox( NULL, "Test 2 passed !!!", "SASTracer client", MB_OK );
}
result = sas_vsengine ->RunVScriptEx("C:\\MyTests\\Test_3.pevs");
if( result == PASSED )
{
::MessageBox( NULL, "Test 3 passed !!!", "SASTracer client", MB_OK );
}
. . .