DTWAIN_SelectOCREngineByName

Top  Previous  Next

The DTWAIN_SelectOCREngineByName function selects an OCR Engine by specifying the OCR engine's product name.

 

DTWAIN_OCRENGINE DTWAIN_SelectOCREngineByName ( LPCTSTR szName );

 

 

Parameters

szName

Points to a null-terminated string containing the name of the OCR Engine.

 

Return Values

If successful, the return value is a non-zero DTWAIN_OCRENGINE specifying the selected OCR Engine.  Otherwise NULL is returned if an OCR  Engine does not have the szName, or if there is an error selecting the OCREngine.

 

Character specific version

ANSI version:

DTWAIN_SelectOCREngineByNameA

Unicode version:

DTWAIN_SelectOCREngineByNameW

 

Comments

The DTWAIN_SelectOCREngineByName function selects the OCR engine that has the same product name as szName.  The product name is the same name that you will see in the  OCR Engine Select dialog's list box.

 

This function is useful if you know the name of the OCR engine to open, and do not wish to display the Select Engine dialog.  One way to initially get any Source's product name is to call DTWAIN_EnumOCRInterfaces.  For each OCR Engine that is found with DTWAIN_EnumOCRInterfaces you can retrieve the product name by calling DTWAIN_GetOCRProductName.

 

Prerequisite Calls

DTWAIN_SysInitialize

DTWAIN_InitOCRInterface

 

Optional Prerequisite Calls

None.