VTI Instruments EX1629, User Manual

Page: 199 / 346

www.vtiinstruments.com
EX1629 Command Set 199
vtex1629_load_stored_config
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_load_stored_config (ViSession vi , ViInt32 digestArraySize , ViInt8 _VI_FAR digest[] ,
ViPInt32 digestActualSize );
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.
digestArraySize = contains the size of the allocated digest array. For consistency, the client application should
allocate VTEX1629_MAX_DIGEST_LENGTH bytes.
digest[] = the stored configuration’s digest.
digestActualSize = the actual configuration digest size.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
This function loads the stored configuration from the instrument’s non-volatile memory. It also returns a copy of the
stored configuration digest, which is a digital signature representing the actual configuration data.
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 digestActualSize;
ViInt8 digest[VTEX1629_MAX_DIGEST_LENGTH];
…
status = vtex1629_load_stored_config(instrumentHandle,
VTEX1629_MAX_DIGEST_LENGTH,
&digestActualSize);