NP_Initialize

« 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.

See Also

NP_Shutdown, NPP_New

Document Tags and Contributors

Tags: 
 Contributors to this page: teoli, Demos, Nickolay, Kazssym, Mgjbot, Pmash
 Last updated by: teoli,