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)