WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsISecurityPref

IID:94afd973-8045-4c6c-89e6-75bdced4209e
Inherits From:nsISupports

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


Methods

void securityClearUserPref ( char* pref_name ) PRBool securityGetBoolPref ( char* pref ) char* securityGetCharPref ( char* pref ) PRInt32 securityGetIntPref ( char* pref ) void securitySetBoolPref ( char* pref , PRBool value ) void securitySetCharPref ( char* pref , char* value ) void securitySetIntPref ( char* pref , PRInt32 value )

void securityClearUserPref ( char* pref_name )

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.

Arguments:
pref_name: The preference to be cleared.
Returns:
Other The preference does not exist or have a user set value.

PRBool securityGetBoolPref ( char* pref )

Called to get the state of a "capability" boolean preference.

Arguments:
pref: The boolean preference to get the state of.
Returns:
boolean The value of the requested boolean preference.

char* securityGetCharPref ( char* pref )

Called to get the state of a "capability" string preference.

Arguments:
pref: The string preference to retrieve.
Returns:
string The value of the requested string preference.

PRInt32 securityGetIntPref ( char* pref )

Called to get the state of a "capability" integer preference.

Arguments:
pref: The integer preference to get the value of.
Returns:
long The value of the requested integer preference.

void securitySetBoolPref ( char* pref , PRBool value )

Called to set the state of a "capability" boolean preference.

Arguments:
pref: The boolean preference to set the state of.
value: The boolean value to set the preference to.
Returns:
Other The value was not set or is the wrong type.

void securitySetCharPref ( char* pref , char* value )

Called to set the state of a "capability" string preference.

Arguments:
pref: The string preference to set.
value: The string value to set the preference to.
Returns:
Other The value was not set or is the wrong type.

void securitySetIntPref ( char* pref , PRInt32 value )

Called to set the state of a "capability" integer preference.

Arguments:
pref: The integer preference to set the value of.
value: The integer value to set the preference to.
Returns:
Other The value was not set or is the wrong type.

Reference documentation is generated from Mozilla's source.

Copyright © 1999-2006 XULPlanet.com