Este método está implementado en FRE for Windows.
Este método se utiliza para obtener un puntero a la interfaz IEngine. Proporciona acceso sencillo al licenciamiento en línea, si es necesario, y también le permite especificar algunos parámetros adicionales durante la inicialización. Recibe como parámetro de entrada el número Customer Project ID, que es una cadena alfanumérica común a todas las licencias Developer y Runtime que utiliza su proyecto.
Tal como está implementado en el objeto InprocLoader, el método carga FineReader Engine como un servidor dentro del proceso actual. Tal como está implementado en el objeto OutprocLoader, el método carga FineReader Engine como un servidor fuera del proceso en un proceso independiente.
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 cadena que contiene el número de Customer Project ID que coincide con la licencia requerida.
Durante la inicialización de la biblioteca, se busca en la lista de todas las licencias disponibles una licencia Developer o Runtime correspondiente a este Customer Project ID. Si no se encuentra ninguna licencia correspondiente, se producirá un error para la última licencia comprobada. No obstante, puede pasar 0 para este parámetro y seleccionar la licencia más adelante llamando al método IEngine::SetCurrentLicense antes de cualquier otro método de la biblioteca.
LicensePath
[in] El nombre completo del archivo de la licencia en línea. Si no utiliza una licencia en línea, pase una cadena vacía "" o un puntero Null.
LicensePassword
[in] La contraseña de la licencia en línea. Si no utiliza una licencia en línea, pase una cadena vacía "" o un puntero Null.
FREngineDataFolder
[in] Contiene la ruta de la carpeta en la que ABBYY FineReader Engine debe almacenar los datos específicos del usuario. De forma predeterminada, para la instalación automática:
%ProgramData%\ABBYY\SDK\12\FineReader Engine for auxiliary engine data
%ProgramData%\ABBYY\SDK\12\Licenses for license data
Si establece el valor de FREngineDataFolder, toda la información auxiliar se escribirá en una nueva carpeta de datos. Puede que tenga que cambiar el valor predeterminado, por ejemplo, si la configuración del idioma de la interfaz de su aplicación debe ser distinta de la de otras aplicaciones que usan FineReader Engine. Después de cambiar el valor predeterminado, asegúrese de tener permisos de control total sobre la nueva carpeta de datos.
FREngineTempFolder
[in] Contiene la ruta de la carpeta para los archivos temporales de ABBYY FineReader Engine. De forma predeterminada, es la carpeta %TEMP%\ABBYY FineReader Engine 12.
IsSharedCPUCoresMode
[in] Especifica si los núcleos de CPU deben usarse en modo compartido. Hay dos modos de uso de los núcleos de CPU: separado y compartido. En el modo separado, ABBYY FineReader Engine no usa más procesos de los permitidos por la licencia. En el modo compartido, se puede ejecutar cualquier número de procesos, pero todos ellos usarán solo los núcleos de CPU especificados por la propiedad IMultiProcessingParams::SharedCPUCoresMask.
Result
[out, retval] Un puntero a una variable de tipo puntero IEngine* que recibe el puntero de interfaz al objeto Engine resultante.
Este método no devuelve valores de retorno específicos. Devuelve los valores de retorno estándar de las funciones de ABBYY FineReader Engine.
IEngineLoader
ExplicitlyUnload
Distintas formas de cargar el objeto Engine