| Evolution-Data-Server Manual: Graphical Utilities (libedataserverui) | ||||
|---|---|---|---|---|
| Top | Description | ||||
void e_passwords_init (void); void e_passwords_shutdown (void); void e_passwords_cancel (void); void e_passwords_set_online (gint state); void e_passwords_remember_password (const gchar *unused,const gchar *key); void e_passwords_add_password (const gchar *key,const gchar *passwd); gchar * e_passwords_get_password (const gchar *unused,const gchar *key); void e_passwords_forget_password (const gchar *unused,const gchar *key); void e_passwords_forget_passwords (void); void e_passwords_clear_passwords (const gchar *unused); enum EPasswordsRememberType; gchar * e_passwords_ask_password (const gchar *title,const gchar *unused,const gchar *key,const gchar *prompt,EPasswordsRememberType remember_type,gboolean *remember,GtkWindow *parent);
void e_passwords_init (void);
Initializes the e_passwords routines. Must be called before any other e_passwords_* function.
void e_passwords_cancel (void);
Cancel any outstanding password operations and close any dialogues currently being shown.
void e_passwords_set_online (gint state);
Set the offline-state of the application. This is a work-around for having the backends fully offline aware, and returns a cancellation response instead of prompting for passwords.
FIXME: This is not a permanent api, review post 2.0.
void e_passwords_remember_password (const gchar *unused,const gchar *key);
Saves the password associated with key to disk.
|
the key |
void e_passwords_add_password (const gchar *key,const gchar *passwd);
This stores the key/passwd pair in the current session's password
hash.
|
a key |
|
the password for key
|
gchar * e_passwords_get_password (const gchar *unused,const gchar *key);
|
the key |
Returns : |
the password associated with key, or NULL. Caller
must free the returned password. |
void e_passwords_forget_password (const gchar *unused,const gchar *key);
Forgets the password associated with key, in memory and on disk.
|
the key |
void e_passwords_forget_passwords (void);
Forgets all cached passwords, in memory and on disk.
void e_passwords_clear_passwords (const gchar *unused);
Forgets all disk cached passwords for the component.
typedef enum {
E_PASSWORDS_REMEMBER_NEVER,
E_PASSWORDS_REMEMBER_SESSION,
E_PASSWORDS_REMEMBER_FOREVER,
E_PASSWORDS_REMEMBER_MASK = 0xf,
/* option bits */
E_PASSWORDS_SECRET = 1<<8,
E_PASSWORDS_REPROMPT = 1<<9,
E_PASSWORDS_ONLINE = 1<<10, /* only ask if we're online */
E_PASSWORDS_DISABLE_REMEMBER = 1<<11, /* disable the 'remember password' checkbox */
E_PASSWORDS_PASSPHRASE = 1<<12 /* We are asking a passphrase */
} EPasswordsRememberType;
gchar * e_passwords_ask_password (const gchar *title,const gchar *unused,const gchar *key,const gchar *prompt,EPasswordsRememberType remember_type,gboolean *remember,GtkWindow *parent);
Asks the user for a password.
|
title for the password dialog |
|
this argument is no longer used |
|
key to store the password under |
|
prompt string |
|
on input, the default state of the remember checkbox. on output, the state of the checkbox when the dialog was closed. |
|
parent window of the dialog, or NULL
|
Returns : |
the password, which the caller must free, or NULL if
the user cancelled the operation. *remember will be set if the
return value is non-NULL and remember_type is not
E_PASSWORDS_DO_NOT_REMEMBER. |