NS_InitXPCOM2 function initiates use of XPCOM in the calling process.
#include "nsXPCOM.h" nsresult NS_InitXPCOM2( nsIServiceManager** aResult, nsIFile* aBinDirectory, nsIDirectoryServiceProvider* aAppFileLocationProvider );
- [out] The resulting XPCOM service manager. You may pass null if you are not interested in this return value. The service manager may alternatively be accessed by calling
NS_GetServiceManager. The resulting interface pointer is
AddRef'd upon return and must either be
Release'd explicitly or passed to
NS_ShutdownXPCOMwhen the application is finished with XPCOM.
- [in] The directory containing the component registry and runtime libraries. Pass null to specify that the current working directory should be used.
- [in] The object to be used by XPCOM to locate application specific directories and files (e.g., the user profile, the component registry, etc.). This parameter may be
NS_InitXPCOM2 function returns
NS_OK if successful. Otherwise, it returns an error code. Some of the possible errors are documented below:
- Indicates that static globals were not yet initialized, which may happen if this method is called before XPCOM's static initialization code executes. This error may also occur if XPCOM is being initialized after
NS_ShutdownXPCOMhas been called.
You must call
NS_InitXPCOM3) before proceeding to use XPCOM in a process. The one exception is that you may call
NS_NewNativeLocalFile to create a
nsIFile needed for the aBinDirectory parameter to
NS_InitXPCOM2. Many of the XPCOM glue functions and classes are also available prior to XPCOM initialization, including for example
This function was finalized for Mozilla 0.9.6. See bug 999147 for details.