DTWAIN_GetOCRVersionInfo

 Top  Previous  Next

The DTWAIN_GetOCRVersionInfo gets an OCR engine's version information.

 

LONG DTWAIN_GetOCRVersionInfo (

DTWAIN_OCRENGINE

Engine,

LPTSTR

szBuffer,

LONG

MaxLen );

 

Parameters

Engine

Specifies an OCR engine.

 

szBuffer

Specifies the address of the character buffer to store the product name or NULL.

 

MaxLen

Specifies the maximum number of characters to copy to szBuffer.

 

 

Return Values

If the function succeeds, the number of characters copied to szBuffer is returned.  If the function fails, DTWAIN_FAILURE1 is returned.

 

Character specific version

ANSI version:

DTWAIN_GetOCRVersionInfoA

Unicode version:

DTWAIN_GetOCRVersionInfoW

 

Comments

The DTWAIN_GetOCRVersionInfo function fills szBuffer with the Version Information associated with the OCR engine Engine. The MaxLen argument is the maximum number of characters to copy to szBuffer, including the trailing null character.

 

If szBuffer is NULL, the length of the Version Information name is returned only.  The returned length includes the length of the name, plus one for the terminating NULL character.  You can use this method to determine the total number of characters needed to store the entire version info.

 

TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN_InitOCRInterface

DTWAIN_EnumOCRInterfaces, or DTWAIN_SelectOCREngine, or DTWAIN_SelectOCREngineByName, or DTWAIN_SelectDefaultOCREngine