« Gecko Plugin API Reference « Plug-in Side Plug-in API
概要
プラグインに対する全体的な初期化を提供します。
文法
Windows
#include <npapi.h> NPError WINAPI NP_Initialize(NPNetscapeFuncs *aNPNFuncs)
Unix
#include <npapi.h> NPError NP_Initialize(NPNetscapeFuncs *aNPNFuncs, NPPluginFuncs *aNPPFuncs)
戻り値
- 成功ならば、この関数は NPERR_NO_ERROR を返します。
- 失敗ならば、プラグインは読みこまれず、関数はエラーコードを返します。返しうる値については、エラーコードを参照してください。
説明
ブラウザは一度だけこの関数を呼びます: 最初のインスタンスが生成される前に、プラグインが読みこまれたときです。これはブラウザが呼ぶ最初の関数です。NP_Initialize はブラウザがプラグインを読み込み全体的な初期化を提供することをプラグインに告知します。このときにプラグインのすべてのインタンスで共有するあらゆるメモリやリソースを割り当ててください。
プラグインの最後インスタンスが削除された後に、ブラウザは NP_Shutdown を呼び、そこで割り当てたメモリやリソースを開放できます。