> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IEngineLoader インターフェイスの InitializeEngine メソッド

> ABBYY FineReader Engine API の IEngineLoader インターフェイスの InitializeEngine メソッド — このメソッドは、IEngine インターフェイスへのポインターを取得するために使用します。

<Note>
  このメソッドは、Windows 版 FRE で実装されています。
</Note>

このメソッドは、[IEngine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) インターフェイスへのポインターを取得するために使用します。必要に応じてオンライン licensing に簡単にアクセスできるほか、初期化時に追加のパラメーターを指定することもできます。入力パラメーターとして Customer Project ID 番号を受け取ります。これは、プロジェクトで使用するすべての Developer ライセンスおよび Runtime ライセンスに共通の英数字の文字列です。

[InprocLoader](/ja/fine-reader/engine/api-reference/engine-loaders/inprocloader) オブジェクトで実装されている場合、このメソッドは FineReader Engine をインプロセス サーバーとして現在のプロセスに読み込みます。[OutprocLoader](/ja/fine-reader/engine/api-reference/engine-loaders/outprocloader) オブジェクトで実装されている場合、このメソッドは FineReader Engine をアウトプロセス サーバーとして別のプロセスに読み込みます。

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```csharp theme={null}
HRESULT __stdcall InitializeEngine(
  BSTR CustomerProjectID,
  BSTR LicensePath,
  BSTR LicensePassword,
  BSTR FREngineDataFolder,
  BSTR FREngineTempFolder,
  VARIANT_BOOL IsSharedCPUCoresMode,
  IEngine** Engine
);
```

### C\#

```csharp theme={null}
int InitializeEngine(
  string CustomerProjectID,
  string LicensePath,
  string LicensePassword,
  string FREngineDataFolder,
  string FREngineTempFolder,
  bool IsSharedCPUCoresMode,
  ref IEngine Engine
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```csharp theme={null}
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
```

<div id="parameters">
  ## パラメーター
</div>

CustomerProjectID

\[in] 必要なライセンスに一致する Customer Project ID 番号を含む string。

<Note>
  ライブラリの初期化時に、この Customer Project ID に対応する Developer License または Runtime License が、使用可能なすべてのライセンスの一覧から検索されます。対応するライセンスが見つからない場合は、最後に確認したライセンスに対するエラーが発生します。ただし、このパラメーターには 0 を渡しておき、他のライブラリメソッドを呼び出す前に [IEngine::SetCurrentLicense](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/setcurrentlicense-method) メソッドを呼び出すことで、後からライセンスを選択することもできます。
</Note>

LicensePath

\[in] Online License ファイルの完全なファイル名です。Online License を使用しない場合は、空の string "" または Null ポインターを渡します。

LicensePassword

\[in] Online License のパスワードです。Online License を使用しない場合は、空の string "" または Null ポインターを渡します。

FREngineDataFolder

\[in] ABBYY FineReader Engine がユーザー固有のデータを保存するフォルダーへのパスを指定します。既定では、自動インストールの場合、次の場所が使用されます。<br />%ProgramData%\ABBYY\SDK\12\FineReader Engine for auxiliary engine data<br />%ProgramData%\ABBYY\SDK\12\Licenses for license data<br />FREngineDataFolder の値を設定すると、すべての補助情報は新しいデータフォルダーに書き込まれます。たとえば、アプリケーションのインターフェイス言語設定を、FineReader Engine を使用する他のアプリケーションとは異なるものにする必要がある場合は、既定値の変更が必要になることがあります。既定値を変更した後は、新しいデータフォルダーに対するフル コントロール権限があることを確認してください。

FREngineTempFolder

\[in] ABBYY FineReader Engine の一時ファイル用フォルダーへのパスを指定します。既定では、%TEMP%\ABBYY FineReader Engine 12 フォルダーです。

IsSharedCPUCoresMode

\[in] CPU コアを共有モードで使用するかどうかを指定します。CPU コアの使用モードには、分離モードと共有モードの 2 つがあります。分離モードでは、ABBYY FineReader Engine はライセンスで許可された数を超えるプロセスを使用しません。共有モードでは任意の数のプロセスを実行できますが、それらのプロセスはすべて [IMultiProcessingParams::SharedCPUCoresMask](/ja/fine-reader/engine/api-reference/parameter-objects/multiprocessingparams#sharedcpucoresmask) プロパティで指定された CPU コアのみを使用します。

Result

\[out, retval] 結果として得られる [Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) object へのインターフェイス ポインターを受け取る IEngine\* ポインター変数へのポインターです。

<div id="return-values">
  ## 戻り値
</div>

このメソッド固有の戻り値はありません。返されるのは、[ABBYY FineReader Engine 関数の標準的な戻り値](/ja/fine-reader/engine/api-reference/return-codes)です。

<div id="see-also">
  ## 関連項目
</div>

[IEngineLoader](/ja/fine-reader/engine/api-reference/engine-loaders/iengineloader)

[ExplicitlyUnload](/ja/fine-reader/engine/api-reference/engine-loaders/iengineloader/explicitlyunload-method)

[Engine オブジェクトをロードするさまざまな方法](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/different-ways-to-load-engine)