Rockwell Automation 1747-PCINT API Software for 1746 I/O - Manual (Page 98)

6–44 Library of Routines OC_GetVersionInfo
Publication 1747-6.5.3 June 1998
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 */
WORD OCHardwareRevision; /* Hardware revision */
} OCVERSIONINFO;
The Windows NT version uses the above structure with these additional members:
WORD OCDriverSeries; /* Device driver series */
WORD OCDriverRevision /* Device driver series revision */
Return Value:
Considerations:
Supported in the DOS API library and the Windows NT API library
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
Name: Value: Description:
SUCCESS
0
version information was read successfully
ERR_OCACCESS 2
handle does not have access to scanner
ERR_OCINIT
5
scanner has not been initialized, see OC_InitScanner