nsILoginManagerPrompter

Please add a summary to this article.
1.0
66
Introduced
Gecko 1.9
Inherits from: nsISupports Last changed in Gecko 1.9 (Firefox 3)

Implemented by: @mozilla.org/login-manager/prompter;1. To call this service, use:

var loginManagerPrompter = Components.classes["@mozilla.org/login-manager/prompter;1"]
                           .getService(Components.interfaces.nsILoginManagerPrompter);

Method overview

void init(in nsIDOMWindow aWindow);
void promptToChangePassword(in nsILoginInfo aOldLogin, in nsILoginInfo aNewLogin);
void promptToChangePasswordWithUsernames([array, size_is(count)] in nsILoginInfo logins, in PRUint32 count, in nsILoginInfo aNewLogin);
void promptToSavePassword(in nsILoginInfo aLogin);

Methods

init()

Initialize the prompter. Must be called before using other interfaces.

void init(
  in nsIDOMWindow aWindow
);
Parameters
aWindow
The in which the user is doing some login-related action that is resulting in a need to prompt them for something. The prompt will be associated with this window (or, if a notification bar is being used, topmost opener in some cases).

promptToChangePassword()

Ask the user if they want to change a login's password. If the user consents, modifyLogin() will be called.

void promptToChangePassword(
  in nsILoginInfo aOldLogin,
  in nsILoginInfo aNewLogin
);
Parameters
aOldLogin
The existing login (with the old password).
aNewLogin
The new login.

promptToChangePasswordWithUsernames()

Ask the user if they want to change the password for one of multiple logins, when the caller can not determine exactly which login should be changed. If the user consents, modifyLogin() will be called.

Note: Because the caller does not know the username of the login to be changed, aNewLogin.username and aNewLogin.usernameField will be set (using the user's selection) before modifyLogin() is called.

void promptToChangePasswordWithUsernames(
  [array, size_is(count)] in nsILoginInfo logins,
  in PRUint32 count,
  in nsILoginInfo aNewLogin
);
Parameters
logins
An array of existing logins.
count
(length of the array)
aNewLogin
The new login.

promptToSavePassword()

Ask the user if they want to save a login (Yes, Never, Not Now)

void promptToSavePassword(
  in nsILoginInfo aLogin
);
Parameters
aLogin
The login to be saved.