NP Initialize

From MDC

« Gecko Plugin API Reference « Plug-in Side Plug-in API

Contents 1 Summary 2 Syntax 2.1 Windows 2.2 Unix 3 Returns 4 Description 5 See Also

[edit] Summary

Provides global initialization for a plug-in.

[edit] Syntax

[edit] Windows

#include <npapi.h>

NPError WINAPI NP_Initialize(NPNetscapeFuncs *aNPNFuncs)

[edit] Unix

#include <npapi.h>

NPError NP_Initialize(NPNetscapeFuncs *aNPNFuncs, NPPluginFuncs *aNPPFuncs)

[edit] 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.

[edit] 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.

[edit] See Also

NP_Shutdown, NPP_New