Zum Hauptinhalt springen
Diese Methode wird in FRE for Windows implementiert.
Diese Methode dient dazu, einen Zeiger auf die IEngine-Schnittstelle abzurufen. Sie bietet bei Bedarf einen einfachen Zugriff auf die Online-Lizenzierung und ermöglicht außerdem, bei der Initialisierung zusätzliche Parameter anzugeben. Als Eingabeparameter erwartet sie die Customer Project ID, eine alphanumerische Zeichenfolge, die allen von Ihrem Projekt verwendeten Developer- und Runtime-Lizenzen gemeinsam ist. In der Implementierung des Objekts InprocLoader lädt die Methode FineReader Engine als In-Process-Server in den aktuellen Prozess. In der Implementierung des Objekts OutprocLoader lädt die Methode FineReader Engine als Out-of-Process-Server in einen separaten Prozess.

Syntax

C++

HRESULT __stdcall InitializeEngine(
  BSTR CustomerProjectID,
  BSTR LicensePath,
  BSTR LicensePassword,
  BSTR FREngineDataFolder,
  BSTR FREngineTempFolder,
  VARIANT_BOOL IsSharedCPUCoresMode,
  IEngine** Engine
);

C#

int InitializeEngine(
  string CustomerProjectID,
  string LicensePath,
  string LicensePassword,
  string FREngineDataFolder,
  string FREngineTempFolder,
  bool IsSharedCPUCoresMode,
  ref IEngine Engine
);

Visual Basic .NET

Private Declare Function InitializeEngine Lib "FREngine.dll" ( _
  CustomerProjectID As String, _
  LicensePath As String, _
  LicensePassword As String, _
  FREngineDataFolder As String, _
  FREngineTempFolder As String, _
  IsSharedCPUCoresMode As Boolean, _
  ByRef Engine As FREngine.IEngine) _
As Integer

Parameter

CustomerProjectID [in] Ein string, der die Nummer der Customer Project ID enthält, die mit der erforderlichen Lizenz übereinstimmt.
Während der Bibliotheksinitialisierung wird die Liste aller verfügbaren Lizenzen nach einer Developer- oder Runtime-Lizenz durchsucht, die dieser Customer Project ID entspricht. Wird keine entsprechende Lizenz gefunden, tritt ein Fehler für die zuletzt geprüfte Lizenz auf. Sie können für diesen Parameter jedoch auch 0 übergeben und die Lizenz später auswählen, indem Sie vor allen anderen Bibliotheksmethoden die Methode IEngine::SetCurrentLicense aufrufen.
LicensePath [in] Der vollständige Dateiname der Online-License-Datei. Wenn Sie keine Online License verwenden, übergeben Sie stattdessen einen leeren string "" oder einen Nullzeiger. LicensePassword [in] Das Passwort der Online License. Wenn Sie keine Online License verwenden, übergeben Sie stattdessen einen leeren string "" oder einen Nullzeiger. FREngineDataFolder [in] Enthält den Pfad zu dem Ordner, in dem ABBYY FineReader Engine benutzerspezifische Daten speichern soll. Standardmäßig bei automatischer Installation:
%ProgramData%\ABBYY\SDK\12\FineReader Engine for auxiliary engine data
%ProgramData%\ABBYY\SDK\12\Licenses for license data
Wenn Sie den Wert für FREngineDataFolder festlegen, werden alle Zusatzinformationen in einen neuen Datenordner geschrieben. Möglicherweise müssen Sie den Standardwert ändern, zum Beispiel wenn die Einstellungen für die Oberflächensprache Ihrer Anwendung von denen anderer Anwendungen abweichen müssen, die FineReader Engine verwenden. Stellen Sie nach dem Ändern des Standardwerts sicher, dass Sie Vollzugriffsberechtigungen für den neuen Datenordner haben.
FREngineTempFolder [in] Enthält den Pfad zum Ordner für temporäre Dateien von ABBYY FineReader Engine. Standardmäßig ist dies der Ordner %TEMP%\ABBYY FineReader Engine 12. IsSharedCPUCoresMode [in] Gibt an, ob die CPU-Kerne im gemeinsamen Modus verwendet werden sollen. Es gibt zwei Modi für die Nutzung von CPU-Kernen: getrennt und gemeinsam. Im getrennten Modus verwendet ABBYY FineReader Engine nicht mehr Prozesse, als durch die Lizenz zulässig sind. Im gemeinsamen Modus kann eine beliebige Anzahl von Prozessen ausgeführt werden, aber alle diese Prozesse verwenden nur die CPU-Kerne, die durch die Eigenschaft IMultiProcessingParams::SharedCPUCoresMask angegeben sind. Result [out, retval] Ein Zeiger auf eine IEngine*-Zeigervariable, die den Schnittstellenzeiger auf das resultierende Engine-Objekt erhält.

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie liefert die Standardrückgabewerte der ABBYY FineReader Engine-Funktionen.

Siehe auch

IEngineLoader ExplicitlyUnload Verschiedene Möglichkeiten, das Engine-Objekt zu laden