« Gecko Plugin API Reference « Plug-in Side Plug-in API
Summary
Provides global initialization for a plug-in.
Syntax
Windows
#include <npapi.h> NPError WINAPI NP_Initialize(NPNetscapeFuncs *aNPNFuncs)
Unix
#include <npapi.h> NPError NP_Initialize(NPNetscapeFuncs *aNPNFuncs, NPPluginFuncs *aNPPFuncs)
Returns
- If successful, the function returns
NPERR_NO_ERROR
. - If unsuccessful, the plug-in is not loaded and the function returns an error code. For possible values, see Error Codes.
Description
The browser calls this function only once: when a plug-in is loaded, before the first instance is created. This is the first function that the browser calls. NP_Initialize
tells the plug-in that the browser has loaded it and provides global initialization. Allocate any memory or resources shared by all instances of your plug-in at this time.
After the last instance of a plug-in has been deleted, the browser calls NP_Shutdown
, where you can release allocated memory or resources.