niDMM_GetCalUserDefinedInfo
ViStatus = niDMM_GetCalUserDefinedInfo(ViSession Instrument_Handle, ViInt32 Buffer_Size, ViChar Info[])
Purpose
Returns the user-defined calibration information stored in the EEPROM.
 |
Note The NI 4050 and NI 4060 are not supported. |
Parameters
| Input | ||
| Name | Type | Description |
| Instrument_Handle | ViSession | Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None. |
| Buffer_Size | ViInt32 | Passes the number of bytes in the ViString you specify for the Info parameter. If zero is passed for this parameter, the Buffer_Size needed to store the information is returned. If the Info parameter, including the terminating NULL byte, contains more bytes than you indicate in this parameter, the function copies Buffer_Size - 1 bytes into the buffer, places an ASCII NULL byte at the end of the buffer, and returns the Buffer_Size you must pass to get the entire value. For example, if the value is "123456" and the Buffer_Size is 4, the function places "123" into the buffer and returns 7. If you pass a negative number, the function copies the value to the buffer regardless of the number of bytes in the value. |
| Output | ||
| Name | Type | Description |
| Info | ViChar[] | Returns the user-defined calibration information stored in the EEPROM. If this is NULL, the Buffer_Size needed to store the information is returned. |
Return Value
| Name | Type | Description |
| Status | ViStatus | Reports the Status of this operation. To obtain a text description of the status code, call niDMM_error_message. To obtain additional information concerning the error condition, use niDMM_GetError. |