跳转到主要内容
此方法在 Windows 版 FRE 中实现。
此方法用于获取指向 IEngine 接口的指针。它可在需要时提供对在线许可功能的便捷访问，并允许您在初始化期间指定一些附加参数。该方法接受 Customer Project ID 编号作为输入参数。该编号是一个字母数字字符串，适用于您的项目所使用的所有 Developer 和 Runtime 许可证。 在 InprocLoader 对象中实现时，该方法会将 FineReader Engine 作为进程内服务器加载到当前进程中。在 OutprocLoader 对象中实现时，该方法会将 FineReader Engine 作为进程外服务器加载到单独的进程中。

​
语法

​
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

​
参数

CustomerProjectID [in] 一个 string，包含与所需许可证匹配的 Customer Project ID 编号。
在库初始化期间，系统会在所有可用许可证中搜索与此 Customer Project ID 对应的 Developer 或 Runtime License。如果未找到对应的许可证，则会返回最后一个已检查许可证的错误。不过，您也可以为此参数传递 0，并在调用任何其他库方法之前，通过调用 IEngine::SetCurrentLicense 方法稍后选择许可证。
LicensePath [in] Online License 文件的完整文件名。如果您不使用 Online License，请改为传递空 string "" 或 Null 指针。 LicensePassword [in] Online License 的密码。如果您不使用 Online License，请改为传递空 string "" 或 Null 指针。 FREngineDataFolder [in] 包含 ABBYY FineReader Engine 用于存储用户特定数据的文件夹路径。默认情况下，在自动安装时：
%ProgramData%\ABBYY\SDK\12\FineReader Engine 用于辅助引擎数据
%ProgramData%\ABBYY\SDK\12\Licenses 用于许可证数据
如果您设置了 FREngineDataFolder 值，所有辅助信息都将写入新的数据文件夹。例如，如果您的应用程序界面语言设置必须与其他使用 FineReader Engine 的应用程序不同，则可能需要更改默认值。更改默认值后，请确保您对新的数据文件夹拥有完全控制权限。 FREngineTempFolder [in] 包含 ABBYY FineReader Engine 临时文件所在文件夹的路径。默认情况下，该文件夹为 %TEMP%\ABBYY FineReader Engine 12。 IsSharedCPUCoresMode [in] 指定是否以共享模式使用 CPU 核心。CPU 核心的使用有两种模式：独占和共享。在独占模式下，ABBYY FineReader Engine 使用的进程数不会超过许可证允许的数量。在共享模式下，可以运行任意数量的进程，但所有这些进程都只会使用由 IMultiProcessingParams::SharedCPUCoresMask 属性指定的 CPU 核心。 Result [out, retval] 指向 IEngine* 指针变量的指针，该变量接收结果 Engine 对象的接口指针。

​
返回值

此方法没有特定返回值。它会返回 ABBYY FineReader Engine 函数的标准返回值。

​
另请参见

IEngineLoader ExplicitlyUnload 加载 Engine 对象的不同方式