VTI Instruments EX1629 - Vtex1629_Get_Stored_Config_Digest

www.vtiinstruments.com
EX1629 Command Set 187
vtex1629_get_stored_config_digest
FUNCTION PROTOTYPE
ViStatus vtex1629_get_stored_config_digest (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 current configuration’s digest.
digestActualSize = the actual configuration digest size.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function retrieves the digest of the instrument configuration saved in non-volatile memory. The digest is a
digital signature representing the configuration data.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 digestActualSize;
ViInt8 digest[VTEX1629_MAX_DIGEST_LENGTH];
…
…
status = vtex1629_get_stored_config_digest (instrumentHandle,
VTEX1629_MAX_DIGEST_LENGTH,
&digestActualSize);