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

LeCroy Corporation Automation API for SAS/SATATracer/Trainer Manual Version 1.11
74
8.1.3 IVScriptEngine::RunVScript
HRESULT RunVScript ( [out, retval] int* pResult )
Runs the verification script currently specified for this engine.
Parameters
pResult Address of the variable where the results of the verification are kept
Return values
Remarks
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.
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("MyVSEngine");
assert( sas_vsengine != NULL );
sas_vsengine -> PutVScriptName("Test_1");
assert( sas_vsengine -> GetVScriptName() == "Test_1" );
VS_RESULT result = sas_vsengine ->RunVScript();
if( result == PASSED )
{
::MessageBox( NULL, "Test 1 passed !!!", "SASTracer client", MB_OK );
}
. . .