Questo metodo è implementato in FRE per Windows.
Questo metodo viene utilizzato per ottenere un puntatore all’interfaccia IEngine. Offre un accesso semplice alla gestione online delle licenze, se necessario, e consente inoltre di specificare alcuni parametri aggiuntivi durante l’inizializzazione. Accetta come parametro di input il numero Customer Project ID, che è una stringa alfanumerica comune a tutte le licenze Developer e Runtime utilizzate nel progetto.
Nell’implementazione dell’oggetto InprocLoader, il metodo carica FineReader Engine come server in-process nel processo corrente. Nell’implementazione dell’oggetto OutprocLoader, il metodo carica FineReader Engine come server out-of-process in un processo separato.
HRESULT __stdcall InitializeEngine(
BSTR CustomerProjectID,
BSTR LicensePath,
BSTR LicensePassword,
BSTR FREngineDataFolder,
BSTR FREngineTempFolder,
VARIANT_BOOL IsSharedCPUCoresMode,
IEngine** Engine
);
int InitializeEngine(
string CustomerProjectID,
string LicensePath,
string LicensePassword,
string FREngineDataFolder,
string FREngineTempFolder,
bool IsSharedCPUCoresMode,
ref IEngine Engine
);
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
CustomerProjectID
[in] Una string contenente il numero di Customer Project ID corrispondente alla licenza richiesta.
Durante l’inizializzazione della libreria, nell’elenco di tutte le licenze disponibili viene cercata una licenza Developer o Runtime corrispondente a questo Customer Project ID. Se non viene trovata alcuna licenza corrispondente, si verificherà un errore relativo all’ultima licenza verificata. Tuttavia, puoi passare 0 per questo parametro e selezionare la licenza in un secondo momento chiamando il metodo IEngine::SetCurrentLicense prima di qualsiasi altro metodo della libreria.
LicensePath
[in] Il nome completo del file della licenza online. Se non utilizzi una licenza online, passa invece una string vuota "" oppure un puntatore Null.
LicensePassword
[in] La password della licenza online. Se non utilizzi una licenza online, passa invece una string vuota "" oppure un puntatore Null.
FREngineDataFolder
[in] Contiene il percorso della cartella in cui ABBYY FineReader Engine deve archiviare i dati specifici dell’utente. Per impostazione predefinita, per l’installazione automatica:
%ProgramData%\ABBYY\SDK\12\FineReader Engine per i dati ausiliari del motore
%ProgramData%\ABBYY\SDK\12\Licenses per i dati delle licenze
Se imposti il valore FREngineDataFolder, tutte le informazioni ausiliarie verranno scritte in una nuova cartella di dati. Potrebbe essere necessario modificare il valore predefinito, ad esempio se le impostazioni della lingua dell’interfaccia della tua applicazione devono essere diverse da quelle di altre applicazioni che utilizzano FineReader Engine. Dopo aver modificato il valore predefinito, assicurati di disporre delle autorizzazioni di controllo completo per la nuova cartella di dati.
FREngineTempFolder
[in] Contiene il percorso della cartella dei file temporanei di ABBYY FineReader Engine. Per impostazione predefinita, è la cartella %TEMP%\ABBYY FineReader Engine 12.
IsSharedCPUCoresMode
[in] Specifica se i core della CPU devono essere utilizzati in modalità condivisa. Esistono due modalità di utilizzo dei core della CPU: separata e condivisa. In modalità separata, ABBYY FineReader Engine non utilizza più processi di quanti ne siano consentiti dalla licenza. In modalità condivisa, può essere eseguito qualsiasi numero di processi, ma tutti questi processi utilizzeranno solo i core della CPU specificati dalla proprietà IMultiProcessingParams::SharedCPUCoresMask.
Result
[out, retval] Un puntatore a una variabile puntatore IEngine* che riceve il puntatore all’interfaccia dell’oggetto Engine risultante.
Questo metodo non ha valori restituiti specifici. Restituisce i valori restituiti standard delle funzioni di ABBYY FineReader Engine.
IEngineLoader
ExplicitlyUnload
Diversi modi di caricare l’oggetto Engine