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

Teledyne LeCroy SASVScriptEngine Object
116 Automation API for Teledyne LeCroy SAS/SATA Protocol Suite
IVScriptEngine::Tag
[propget] HRESULT Tag ( [out, retval] int* pVal )
[propget] HRESULT Tag ( [in] int newVal )
Property assigns and gets a tag to the VSE object. This tag is used in event notifications,
allowing a client event handler to determine which VSE object sent the event.
Parameters
pVal Address of the variable where the current VSE tag is kept
newVal New tag for VSE
Return Value
Remarks
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("Test_1");
assert( sas_vsengine != NULL );
sas_vsengine ->PutTag( 0xDDAADDAA );
assert( sas_vsengine -> GetTag() == 0xDDAADDAA );
VS_RESULT result = sas_vsengine ->RunVScript();
if( result == PASSED )
{
::MessageBox( NULL, "Test 1 passed !!!", "SASTracer
client", MB_OK );
}
. . .