nsIWindowsShellService

Please add a summary to this article.
Inherits from: nsIShellService Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Method overview

string getRegistryEntry(in long aHKeyConstant, in string aSubKeyName, in string aValueName); Obsolete since Gecko 1.8
void restoreFileSettings(in boolean aForAllUsers); Obsolete since Gecko 1.9
void shortcutMaintenance();

Attributes

Attribute Type Description
desktopBackgroundColor unsigned long The desktop background color, visible when no background image is used, or if the background image is centered and does not fill the entire screen. A rgb value, where (r << 24 | g << 16 | b) Obsolete since Gecko 1.8
unreadMailCount unsigned long The number of unread mail messages for the current user. Read only.

Constants

Valid starting keys for the Windows Registry.

Constant Value Description
HKCR 0 HKEY_CLASSES_ROOT. Obsolete since Gecko 1.8
HKCC 1 HKEY_CURRENT_CONFIG. Obsolete since Gecko 1.8
HKCU 2 HKEY_CURRENT_USER. Obsolete since Gecko 1.8
HKLM 3 HKEY_LOCAL_MACHINE. Obsolete since Gecko 1.8
HKU 4 HKEY_USERS. Obsolete since Gecko 1.8

Methods

Obsolete since Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)

getRegistryEntry()

Retrieves a Windows Registry entry value.

string getRegistryEntry(
  in long aHKeyConstant,
  in string aSubKeyName,
  in string aValueName
);
Parameters
aHKeyConstant
The starting key, using the constants defined above.
aSubKeyName
The sub key to locate.
aValueName
The value to locate in the sub key. The empty string returns the default value of the sub key.
Return value

The value of the specified sub key/value, truncated to 4096 bytes.

Obsolete since Gecko 1.9 (Firefox 3)

restoreFileSettings()

Restores system settings to what they were before Firefox modified them.

void restoreFileSettings(
  in boolean aForAllUsers 
);
Parameters
aForAllUsers
Whether or not Firefox should restore settings for all users on a multi-user system.

Requires Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

shortcutMaintenance()

Provides the shell service an opportunity to do some Win7+ shortcut maintenance needed on initial startup of the browser.

void shortcutMaintenance();
Parameters

None.

Document Tags and Contributors

 Contributors to this page: Sheppy, trevorh
 Last updated by: Sheppy,