VTI Instruments EX1629 - Vtex1629_Store_Current_Config

VTI Instruments Corp.
298 EX1629 Command Set
vtex1629_store_current_config
FUNCTION PROTOTYPE
ViStatus vtex1629_store_current_config (ViSession vi, ViInt32 digestArraySize, ViInt8 _VI_FAR digest[],
ViPInt32 digestActualSize);
FUNCTION PARAMETERS
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 size of the configuration digest.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function stores the current configuration of the instrument in the nonvolatile storage. A digest of the stored
configuration is returned. The digest is a digital signature representing the actual configuration data.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 digestActualSize;
ViInt8 digest[VTEX1629_MAX_DIGEST_LENGTH];
…
status = vtex1629_store_current_config(instrumentHandle,
VTEX1629_MAX_DIGEST_LENGTH,
digest,
&digestActualSize);