This interface provides methods to initialize and configure a directory service instance. The XPCOM Directory Service implements this interface to provide support for a variety of well-known file and directory locations.
Inherits from:
nsISupports
Last changed in Gecko 1.7 Method overview
void init(); |
void registerProvider(in nsIDirectoryServiceProvider prov); |
void unregisterProvider(in nsIDirectoryServiceProvider prov); |
init()
Initializes the nsIDirectoryService
instance.
This method must be called before an nsIDirectoryService
instance can be used. In the case of the XPCOM Directory Service, this method is called as part of XPCOM initialization.
Must not be called by external code; called internally by XPCOM initialization.
void init();
Parameters
None.
registerProvider()
Register a provider with the service.
The directory service will keep a strong reference to the nsIDirectoryServiceProvider
instances registered via registerProvider
. The providers will be released when the service is destroyed at XPCOM shutdown.
Call unregisterProvider()
to force the directory service to relinquish ownership of a particular provider instance.
void registerProvider( in nsIDirectoryServiceProvider prov );
Parameters
prov
- The
nsIDirectoryServiceProvider
to register with the service.
unregisterProvider()
Unregister a provider that was previously registered with the directory service.
void unregisterProvider( in nsIDirectoryServiceProvider prov );
Parameters
prov
- The
nsIDirectoryServiceProvider
to unregister from the service.