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:
- In the Component Services window (Start > Settings > Control Panel > Administrative Tools > Component Services), select Component Services > Computers > My Computer > COM+ Applications.
- 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.
- 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
- 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.
- 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."
- 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:
- the IClient::CreateXmlTicket method for creating an XmlTicket object
- the IClient::CreateOutputFormatSettings method for creating objects derived from an OutputFormatSettings object.
26.03.2024 13:49:49