|  |  |  | Evolution Utilities Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
void e_passwords_init (void); void e_passwords_set_online (gint state); void e_passwords_remember_password (const gchar *key); void e_passwords_add_password (const gchar *key,const gchar *passwd); gchar * e_passwords_get_password (const gchar *key); void e_passwords_forget_password (const gchar *key); enum EPasswordsRememberType; gchar * e_passwords_ask_password (const gchar *title,const gchar *key,const gchar *prompt,EPasswordsRememberType remember_type,gboolean *remember,GtkWindow *parent);
void                e_passwords_init                    (void);
e_passwords_init is deprecated and should not be used in newly-written code.
Initializes the e_passwords routines. Must be called before any other e_passwords_* function.
void                e_passwords_set_online              (gint state);
e_passwords_set_online is deprecated and should not be used in newly-written code.
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 *key);
e_passwords_remember_password is deprecated and should not be used in newly-written code.
Saves the password associated with key to disk.
| 
 | the key | 
void e_passwords_add_password (const gchar *key,const gchar *passwd);
e_passwords_add_password is deprecated and should not be used in newly-written code.
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 *key);
e_passwords_get_password is deprecated and should not be used in newly-written code.
| 
 | the key | 
| Returns : | the password associated with key, orNULL.  Caller
must free the returned password. | 
void                e_passwords_forget_password         (const gchar *key);
e_passwords_forget_password is deprecated and should not be used in newly-written code.
Forgets the password associated with key, in memory and on disk.
| 
 | the key | 
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;
EPasswordsRememberType is deprecated and should not be used in newly-written code.
gchar * e_passwords_ask_password (const gchar *title,const gchar *key,const gchar *prompt,EPasswordsRememberType remember_type,gboolean *remember,GtkWindow *parent);
e_passwords_ask_password is deprecated and should not be used in newly-written code.
Asks the user for a password.
| 
 | title for the password dialog | 
| 
 | key to store the password under | 
| 
 | prompt string | 
| 
 | whether or not to offer to remember the password, and for how long. | 
| 
 | 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 NULLif
the user cancelled the operation. *rememberwill be set if the
return value is non-NULLandremember_typeis not
E_PASSWORDS_DO_NOT_REMEMBER. |