Méthode InitializeEngine de l’interface IEngineLoader

Cette méthode est implémentée dans FRE pour Windows.

Cette méthode permet d’obtenir un pointeur vers l’interface IEngine. Elle fournit un accès simple à la licence en ligne si nécessaire et vous permet également de spécifier des paramètres supplémentaires lors de l’initialisation. Elle prend en paramètre d’entrée le numéro Customer Project ID, qui est une chaîne alphanumérique commune à toutes les licences Developer et Runtime utilisées par votre projet.

Dans l’objet InprocLoader, la méthode charge FineReader Engine en tant que serveur in-process dans le processus en cours. Dans l’objet OutprocLoader, la méthode charge FineReader Engine en tant que serveur out-of-process dans un processus distinct.

​

Syntaxe

​

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

​

Paramètres

CustomerProjectID

[in] Une string contenant le numéro de Customer Project ID correspondant à la licence requise.

Lors de l’initialisation de la bibliothèque, la liste de toutes les licences disponibles est parcourue à la recherche d’une Developer License ou d’une Runtime License correspondant à ce Customer Project ID. Si aucune licence correspondante n’est trouvée, une erreur relative à la dernière licence vérifiée se produira. Vous pouvez toutefois passer 0 pour ce paramètre et sélectionner la licence ultérieurement en appelant la méthode IEngine::SetCurrentLicense avant toute autre méthode de la bibliothèque.

LicensePath

[in] Le nom complet du fichier de licence en ligne. Si vous n’utilisez pas de licence en ligne, passez une string vide "" ou un pointeur Null à la place.

LicensePassword

[in] Le mot de passe de la licence en ligne. Si vous n’utilisez pas de licence en ligne, passez une string vide "" ou un pointeur Null à la place.

FREngineDataFolder

[in] Contient le chemin d’accès au dossier dans lequel ABBYY FineReader Engine doit stocker les données propres à l’utilisateur. Par défaut, pour une installation automatique :
%ProgramData%\ABBYY\SDK\12\FineReader Engine for auxiliary engine data
%ProgramData%\ABBYY\SDK\12\Licenses for license data
Si vous définissez la valeur FREngineDataFolder, toutes les informations auxiliaires seront écrites dans un nouveau dossier de données. Vous devrez peut-être modifier la valeur par défaut, par exemple si les paramètres de langue de l’interface de votre application doivent être différents de ceux d’autres applications utilisant FineReader Engine. Après avoir modifié cette valeur par défaut, assurez-vous de disposer des autorisations de contrôle total sur le nouveau dossier de données.

FREngineTempFolder

[in] Contient le chemin d’accès au dossier des fichiers temporaires d’ABBYY FineReader Engine. Par défaut, il s’agit du dossier %TEMP%\ABBYY FineReader Engine 12.

IsSharedCPUCoresMode

[in] Indique si les cœurs du processeur doivent être utilisés en mode partagé. Il existe deux modes d’utilisation des cœurs du processeur : séparé et partagé. En mode séparé, ABBYY FineReader Engine n’utilise pas plus de processus que ce que la licence autorise. En mode partagé, un nombre quelconque de processus peut être exécuté, mais tous ces processus n’utiliseront que les cœurs du processeur spécifiés par la propriété IMultiProcessingParams::SharedCPUCoresMask.

Result

[out, retval] Pointeur vers une variable pointeur IEngine* qui reçoit le pointeur d’interface vers l’objet Engine résultant.

​

Valeurs de retour

Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions ABBYY FineReader Engine.

​

Voir aussi

IEngineLoader

ExplicitlyUnload

Différentes manières de charger l’objet Engine