Linux Mac OSX Windows 
 Interface for accessing preferences, bypassing the usual security check on
 preferences starting with "capability". This interface is used by
 nsScriptSecurityManager which needs unchecked access to security prefs. 
 *PLEASE* do not call this interface from any other file, as this 
 would be insecure.

 THIS INTERFACE SHOULD NEVER BE MADE SCRIPTABLE 

 @see nsIPrefBranch
[uuid(94afd973-8045-4c6c-89e6-75bdced4209e)]
interface nsISecurityPref : nsISupports

Methods

 Called to clear a user set value from a "capability" preference. This
 will, in effect, reset the value to the default value. If no default value
 exists the preference will cease to exist.

 @param pref_name The preference to be cleared.

 @note
 This method does nothing if this object is a default branch.

 @return NS_OK The user preference was successfully cleared.
 @return Other The preference does not exist or have a user set value.
void securityClearUserPref(in string pref_name) 
 Called to get the state of a "capability" boolean preference.

 @param pref     The boolean preference to get the state of.

 @return boolean The value of the requested boolean preference.

 @see securitySetBoolPref
boolean securityGetBoolPref(in string pref) 
 Called to get the state of a "capability" string preference.

 @param pref    The string preference to retrieve.

 @return string The value of the requested string preference.

 @see securitySetCharPref
string securityGetCharPref(in string pref) 
 Called to get the state of a "capability" integer preference.

 @param pref  The integer preference to get the value of.

 @return long The value of the requested integer preference.

 @see securitySetIntPref
long securityGetIntPref(in string pref) 
 Called to set the state of a "capability" boolean preference.

 @param pref   The boolean preference to set the state of.
 @param value  The boolean value to set the preference to.

 @return NS_OK The value was successfully set.
 @return Other The value was not set or is the wrong type.

 @see securityGetBoolPref
void securitySetBoolPref(in string pref, in boolean value) 
 Called to set the state of a "capability" string preference.

 @param pref   The string preference to set.
 @param value  The string value to set the preference to.

 @return NS_OK The value was successfully set.
 @return Other The value was not set or is the wrong type.

 @see securityGetCharPref
void securitySetCharPref(in string pref, in string value) 
 Called to set the state of a "capability" integer preference.

 @param pref   The integer preference to set the value of.
 @param value  The integer value to set the preference to.

 @return NS_OK The value was successfully set.
 @return Other The value was not set or is the wrong type.

 @see securityGetIntPref
void securitySetIntPref(in string pref, in long value)