跳轉到主要內容
此方法在 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] 包含 Customer Project ID 編號的 string，且必須與所需的授權相符。
在程式庫初始化期間，系統會在所有可用授權清單中搜尋與此 Customer Project ID 對應的 Developer 或 Runtime License。若找不到對應的授權，則會發生最後一個受檢查授權的錯誤。不過，您也可以為此參數傳遞 0，並在呼叫任何其他程式庫方法之前，透過呼叫 IEngine::SetCurrentLicense 方法稍後選取授權。
LicensePath [in] Online License 檔案的完整檔名。如果您不使用 Online License，請傳遞空字串 "" 或 Null 指標。 LicensePassword [in] Online License 的密碼。如果您不使用 Online License，請傳遞空字串 "" 或 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 object 的介面指標。

​
傳回值

此方法沒有特定的傳回值。它會傳回 ABBYY FineReader Engine 函式的標準傳回值。

​
另請參閱

IEngineLoader ExplicitlyUnload 載入 Engine 物件的不同方式