VTI Instruments EX1000A, User Manual

Page: 204 / 320

VTI Instruments Corp.
204 EX10xxA/RX1032/EX1044 Function Calls
vtex10xxA_lock
F
UNCTION
P
ROTOTYPE
ViStatus vtex10xxA_lock(ViSession vi );
F
UNCTION
P
ARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
This function attempts to acquire a lock on the instrument. When locked, the EX10xxA will accept function calls
from only the host IP address that issued the lock command. A lock can only be acquired if the instrument is not
already locked by another user.
By design, the locking mechanism is able to be overridden by a secondary host that issues a vtex10xxA_break_lock
function. Thus, the lock provides a warning to other users that the unit is in a protected operation state, but not
absolute security.
The lock status of the instrument is unaffected by the vtex10xxA_reset function.
Self-calibration requires the acquisition of a lock prior to its initiation.
E
XAMPLE