CのメインAPIのインスタンス・ハンドル

インスタンス・ハンドル(概念的にはファイル・ハンドルと同様)は、APIへのプログラム・アクセスを示し、API内で使用されるプログラム固有のリソースと設定を識別します。この種の識別は、複数のプログラムによって同時にアクセスされることのある動的共有ライブラリでは必要です。EssInit()の呼出しによって、プログラムがAPIを初期化すると、インスタンス・ハンドルが戻されます。

アプリケーションにおけるインスタンス・ハンドルの使用

Cプログラムでは、インスタンス・ハンドルはESS_HINST_T型として宣言します。

インスタンス・ハンドルは、EssLogin()を呼び出すときに渡す必要があります。この関数からはコンテキスト・ハンドルが戻されます。また、APIで使用したプログラム固有のリソースをすべて解放するには、API終了関数EssTerm()に渡す必要があります。

インスタンス・ハンドルを他のプログラム、子プロセス、またはスレッドに渡して、同じAPIリソースと設定を使用して個別にログインできます。同じインスタンス・ハンドルを使用しているすべてのプログラム、プロセス、またはスレッドがAPIの終了前に必ずログアウトしていることを確認してください。