Back to index

lightning-sunbird  0.9+nobinonly
Public Member Functions | Public Attributes
nsIProfileMigrator Interface Reference

Migrate application settings from an outside source. More...

import "nsIProfileMigrator.idl";

Inheritance diagram for nsIProfileMigrator:
Inheritance graph
Collaboration diagram for nsIProfileMigrator:
Collaboration graph

List of all members.

Public Member Functions

void migrate (in nsIProfileStartup aStartup)
 Do profile migration.

Public Attributes

 Import existing profile paths.

Detailed Description

Migrate application settings from an outside source.

Application (Profile-migration code) Toolkit (Startup code) service, contractid(";1")

Definition at line 73 of file nsIProfileMigrator.idl.

Member Function Documentation

Do profile migration.

When this method is called, a default profile has been created; XPCOM has been initialized such that compreg.dat is in the profile; the directory service does not return a key for NS_APP_USER_PROFILE_50_DIR or any of the keys depending on an active profile. To figure out the directory of the "current" profile, use

If your migrator needs to access services that use the profile (to set profile prefs or bookmarks, for example), use aStartup.doStartup.

The startup code ignores COM exceptions thrown from this method.

Member Data Documentation

Import existing profile paths.

When the app is started the first time, if there are no INI-style profiles, appstartup will call this method to import any registry- style profiles that may exist. When this method is called, there is no event queue service and this method should not attempt to use the network or show any GUI.

You don't actually have to move the profile data. Just call nsIToolkitProfileService.create on the existing profile path(s).

Definition at line 86 of file nsIProfileMigrator.idl.

The documentation for this interface was generated from the following file: