2 Visual Components Manuals

}
}
}
3.3.8.28 Requirements and Initialization − VA_Setup
Sets up a connection to Runtime. Runtime, including all drivers, must be on the target system, and the panel
project must have been started already.
If the function is successful, then a handle is returned. This handle must be transferred when any other VISAPI
functions are used.
If VA_Setup fails (returns 0), then the function must be called cyclically until a valid handle is returned.
3.3.8.28.1 Parameter
I/O Parameter Type Meaning
IN enable BOOL This function is only executed if enable is TRUE.
IN interpreter STRING[80]
OUT Return
Value
UDINT
3.3.8.28.2 Example for Automation Basic
(* cyclic program *)
if ready 1 then
VC_HANDLE = VA_Setup(1 "Visu") ,
VC_HANDLE if 0 then
ready = 1
endif
endif
('Visu' is the name of the panel object)
3.3.8.28.3 Example for C Programming
#include
#include
#include
UINT _GLOBAL ready;
unsigned long VC_HANDLE;
_CYCLIC void Cyclic(void)
{
if (!ready)
{
VC_HANDLE = VA_Setup(1 "Visu"); ,
if (VC_HANDLE)
ready = 1;
}
The name of the project runnning must be specified here.
Introduction to Visual Components 2.3
The handle which must be specified for all further VISAPI functions.
0 is returned if an error occurs.
164 3.3.8.28 Requirements and Initialization − VA_Setup