nsIAuthPrompt 编辑

netwerk/base/public/nsIAuthPrompt.idlScriptable This interface allows the networking layer to pose a user/password prompt to obtain the values needed for authentication. Inherits from: nsISupports Last changed in Gecko 1.9 (Firefox 3)

This interface is implemented by @mozilla.org/login-manager/prompter;1. To create an instance, use:

var authPrompt = Components.classes["@mozilla.org/login-manager/prompter;1"]
                 .createInstance(Components.interfaces.nsIAuthPrompt);

Method overview

boolean prompt(in wstring dialogTitle, in wstring text, in wstring passwordRealm, in PRUint32 savePassword, in wstring defaultText, out wstring result);

boolean promptPassword(in wstring dialogTitle, in wstring text, in wstring passwordRealm, in PRUint32 savePassword, inout wstring pwd);

boolean promptUsernameAndPassword(in wstring dialogTitle, in wstring text, in wstring passwordRealm, in PRUint32 savePassword, inout wstring user, inout wstring pwd);

Constants

Constant	Value	Description
SAVE_PASSWORD_NEVER	0	Never saves the password.
SAVE_PASSWORD_FOR_SESSION	1	Saves the password for the session.
SAVE_PASSWORD_PERMANENTLY	2	Saves the password permanently.

Methods

prompt()

This method puts up a text input dialog with OK and Cancel buttons.

boolean prompt(
  in wstring dialogTitle,
  in wstring text,
  in wstring passwordRealm,
  in PRUint32 savePassword,
  in wstring defaultText,
  out wstring result
);

Parameters

dialogTitle

The title of the dialog.

text

The text of the prompt message dialog box.

passwordRealm

The password realm. For example, ldap://localhost/dc=test.

savePassword

Saving password option. One of the SAVE_PASSWORD_* constants

defaultText

The default text for the text input dialog box.

result

The result of the dialog box, OK or Cancel buttons.

Return value

true for OK, false for Cancel.

promptPassword()

This method puts up a password dialog with OK and Cancel buttons.

Note: If a username is specified, the username should be escaped.

boolean promptPassword(
  in wstring dialogTitle,
  in wstring text,
  in wstring passwordRealm,
  in PRUint32 savePassword,
  inout wstring pwd
);

Parameters

dialogTitle

The title of the dialog.

text

The text of the prompt message dialog box.

passwordRealm

The password realm. For example, ldap://localhost/dc=test. If a username is specified (http://user@site.com) it will be used when matching existing logins or saving new ones. If no username is specified, only password-only logins will be matched or saved.

savePassword

Saving password option. One of the SAVE_PASSWORD_* constants

pwd

The password entered by the user if OK was selected.

Return value

true for OK, false for Cancel.

promptUsernameAndPassword()

This method puts up a username/password dialog with OK and Cancel buttons.

boolean promptUsernameAndPassword(
  in wstring dialogTitle,
  in wstring text,
  in wstring passwordRealm,
  in PRUint32 savePassword,
  inout wstring user,
  inout wstring pwd
);

Parameters

dialogTitle

The title of the dialog.

text

The text of the prompt message dialog box.

passwordRealm

The password realm. For example, ldap://localhost/dc=test.

savePassword

Saving password option. One of the SAVE_PASSWORD_* constants

user

The username entered in the dialog.

pwd

The password entered by the user if OK was selected.

Return value

true for OK, false for Cancel.