NS_ShutdownXPCOM

Summary

The NS_ShutdownXPCOM function terminates use of XPCOM in the calling process.

#include "nsXPCOM.h"
 
nsresult NS_ShutdownXPCOM(
  nsIServiceManager* aSvcManager
);

Parameters

aSvcManager: [in] The nsIServiceManager instance that was returned by NS_InitXPCOM2 (or NS_InitXPCOM3) or null.

Return Values

The NS_ShutdownXPCOM function returns NS_OK if successful. Otherwise, it returns an error code.

Remarks

You must call this method once you are finished using XPCOM.

Calling this method triggers the "xpcom-shutdown" notification to be dispatched to observers. Once this function has been called, the nsIComponentManager and nsIServiceManager will refuse to return object instances.

History

This function was finalized for Mozilla 0.9.6. See bug bug 99147 for details.