Using the COM-based API within 64-bit applications (COM-based API)

The ABBYY FineReader Server setup program automatically configures the system to the use COM-based API.

For troubleshooting purposes, see the steps that are required for manual configuration.

To create a COM+ application, do the following:

  1. In the Component Services window (Start > Settings > Control Panel > Administrative Tools > Component Services), select Component Services > Computers > My Computer > COM+ Applications.
  2. On the shortcut menu of the COM+ Applications item, select New > Application. In the COM+ Application Install Wizard, click Next > Create an empty application > Server application. Enter a name for the application. Click Next and specify the application identity, i.e. the same user account that is used for running the ABBYY FineReader Server service (Select Start  > Control Panel  > Administrative Tools  > Services and see ABBYY FineReader Server 14 Server Manager service). A new application will be displayed in the tree on the left.
  3. On the shortcut menu of the Components item of the newly created application, select New > Component. In the COM+ Component Install Wizard, click Next > Import components that are already registered. Select the 32-Bit Registry item and choose the following components:
    • ABBYYFineReaderServer14.Client.14
    • ABBYYFineReaderServer14.JobDocument.14
    • ABBYYFineReaderServer14.XmlTicket.14
    • ABBYYFineReaderServer14.XmlTicketInputFile.14
    • ABBYYFineReaderServer14.XmlResult.14
    • ABBYYFineReaderServer14.XmlResultInputFile.14
    • ABBYYFineReaderServer14.AltoExportSettings.14
    • ABBYYFineReaderServer14.CSVExportSettings.14
    • ABBYYFineReaderServer14.DOCXExportSettings.14
    • ABBYYFineReaderServer14.EpubExportSettings.14
    • ABBYYFineReaderServer14.HTMLExportSettings.14
    • ABBYYFineReaderServer14.InternalFormatExportSettings.14
    • ABBYYFineReaderServer14.JBig2ExportSettings.14
    • ABBYYFineReaderServer14.Jpeg2kExportSettings.14
    • ABBYYFineReaderServer14.JpegExportSettings.14
    • ABBYYFineReaderServer14.MSWordExportSettings.14
    • ABBYYFineReaderServer14.NoConversionExportSettings.14
    • ABBYYFineReaderServer14.PDFAExportSettings.14
    • ABBYYFineReaderServer14.PDFEExportSettings.14
    • ABBYYFineReaderServer14.PDFExportSettings.14
    • ABBYYFineReaderServer14.PngExportSettings.14
    • ABBYYFineReaderServer14.RTFExportSettings.14
    • ABBYYFineReaderServer14.TextExportSettings.14
    • ABBYYFineReaderServer14.TiffExportSettings.14
    • ABBYYFineReaderServer14.XLExportSettings.14
    • ABBYYFineReaderServer14.XLSXExportSettings.14
    • ABBYYFineReaderServer14.XMLExportSettings.14
    • ABBYYFineReaderServer14.StringsCollection.14
  4. For each component in the list, disable the Enforce component level access checks option. To achieve this, go to the component Properties dialog box and click the Security tab.
  5. Each user that is supposed to use the COM-based API should be allowed to use the COM+ application.

    To grant the necessary permissions, do the following:
    • Select Start > Control Panel > Administrative Tools > Component Services.
    • Find the configured COM+ application.
    • Open the list of roles and add a role. You can use any name for the role, for example "APIUsers."
    • Finally, add the desired user to this role. To allow any user to use the COM-based API, add the user "Everyone."
  6. Register OCRServerClient.dll:
    • Select Start > Run > cmd.
    • Enter "regsvr32" and the path to the OCRServerClient.dll, for example: regsvr32 "C:\Program Files\ABBYY FineReader Server 14.0\Bin\OCRServerClient.dll"

After the COM+ application is created, the COM-based API can be used within 64-bit project with the following limitation: You must not use objects created with the help of the operator new and the CoCreateInstance method as the input parameters of the methods of COM-based API objects. Instead, use:


26.03.2024 13:49:49

Please leave your feedback about this article

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.