nsIToolkitProfile 编辑

toolkit/profile/public/nsIToolkitProfile.idlScriptable Represents a user profile. Inherits from: nsISupports Last changed in Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)

You should not create these objects yourself; to obtain them, use the nsIToolkitProfileService interface to create and obtain them.

 

Method overview

nsIProfileLock lock(out nsIProfileUnlocker aUnlocker);

void remove(in boolean removeFiles);

Attributes

Attribute	Type	Description
localDir	nsILocalFile	The location of the profile local directory, which may be the same as the root directory. See nsIProfileLock.localDirectory(). Read only.
name	AUTF8String	The profile's name.
rootDir	nsILocalFile	The location of the profile directory. Read only.

Methods

lock()

Locks the profile using platform-specific locking methods.

nsIProfileLock lock(
  out nsIProfileUnlocker aUnlocker
);

Parameters

aUnlocker

On error, contains an nsIProfileUnlocker object you can use to unlock the profile. Note: The unlocker object cannot be returned to JavaScript as the error causes an exception to be thrown. The unlocker object is only available in Gecko 34 or later when running on Windows Vista or later.

Return value

An nsIProfileLock object which holds a profile lock as long as you hold a reference to it.

Example:

var profile = profileList.getNext().QueryInterface(Ci.nsIToolkitProfile);

var locker = profile.lock({});

remove()

Removes the profile from the registry of profiles.

void remove(
  in boolean removeFiles
);

Parameters

removeFiles

Indicates whether or not the profile directory should be removed when the profile is removed from the profile list.

See also

• Profile management
• nsIToolkitProfileService
• nsIProfileLock
• nsIProfileUnlocker