Ivscriptengine::runvscript – Teledyne LeCroy SAS_SATA Automation API manual User Manual

Page 123

Advertising
background image

 

Automation API for Teledyne LeCroy SAS/SATA Protocol Suite

117

SASVScriptEngine Object

Teledyne LeCroy

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 Value

Remarks

The name of the verification script is the name of the verification script file (*.pevs). If 
only the script name, without a 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

C++:
// This example uses 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 );

}
. . .

Advertising