Oc_getversioninfo, Oc_getversioninfo -38, Return value: considerations – Rockwell Automation 1747-PCIS API Software - Open Controller User Manual
Page 98: Example, Syntax, Parameters: description

Publication 1747-UM002A-US-P - June 2000
6-38 Library of Routines
Return Value:
Considerations:
Supported in the DOS API library and the Windows NT API library
Example:
HANDLE
Handle;
int
led_state;
int
retcode;
retcode = OC_GetUserLEDState( Handle, 1, &led_state );
OC_GetVersionInfo
OC_GetVersionInfo retrieves the current version of the API library,
1746 I/O PCI Interface hardware, and scanner firmware.
Syntax:
int
OC_GetVersionInfo(HANDLE handle, OCVERSIONINFO
*verinfo);
Parameters:
Description:
The scanner must be initialized before this function returns valid
version information.
The
OCVERSIONINFO
structure is defined as:
typedef struct tagOCVERSIONINFO
{
WORD
APISeries;/* API series */
WORD
APIRevision;/* API revision */
WORD
ScannerFirmwareSeries;/* Scanner firmware
series */
WORD
ScannerFirmwareRevision;/* Scanner firmware
revision */
WORD
OCHardwareSeries;/* Hardware series */
Name:
Value:
Description:
SUCCESS
0
LED was read successfully
ERR_OCACCESS
2
handle
does not have access to scanner
Parameter:
Description:
handle
Must be a valid handle returned from OC_OpenScanner
verinfo
Returns the current version of the API library, 1746 I/O PCI Interface
hardware, and scanner firmware