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
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
Optional Prerequisite Calls None.
|