| Top |  |  |  |  | 
| ECredentials * | e_credentials_new () | 
| ECredentials * | e_credentials_new_strv () | 
| ECredentials * | e_credentials_new_args () | 
| ECredentials * | e_credentials_new_clone () | 
| void | e_credentials_free () | 
| gchar ** | e_credentials_to_strv () | 
| void | e_credentials_set () | 
| gchar * | e_credentials_get () | 
| const gchar * | e_credentials_peek () | 
| gboolean | e_credentials_equal () | 
| gboolean | e_credentials_equal_keys () | 
| gboolean | e_credentials_has_key () | 
| guint | e_credentials_keys_size () | 
| GSList * | e_credentials_list_keys () | 
| void | e_credentials_clear () | 
| void | e_credentials_clear_peek () | 
| void | e_credentials_util_safe_free_string () | 
| gchar * | e_credentials_util_prompt_flags_to_string () | 
| guint | e_credentials_util_string_to_prompt_flags () | 
| struct | ECredentials | 
| #define | E_CREDENTIALS_KEY_USERNAME | 
| #define | E_CREDENTIALS_KEY_PASSWORD | 
| #define | E_CREDENTIALS_KEY_AUTH_METHOD | 
| #define | E_CREDENTIALS_KEY_PROMPT_TITLE | 
| #define | E_CREDENTIALS_KEY_PROMPT_TEXT | 
| #define | E_CREDENTIALS_KEY_PROMPT_REASON | 
| #define | E_CREDENTIALS_KEY_PROMPT_KEY | 
| #define | E_CREDENTIALS_KEY_PROMPT_FLAGS | 
| #define | E_CREDENTIALS_KEY_FOREIGN_REQUEST | 
| enum | ECredentialsPromptFlags | 
| ECredentialsPrivate | 
ECredentials *
e_credentials_new (void);
e_credentials_new is deprecated and should not be used in newly-written code.
Since: 3.2
ECredentials *
e_credentials_new_strv (const gchar * const *strv);
e_credentials_new_strv is deprecated and should not be used in newly-written code.
Creates a new ECredentials with prefilled key/value-s from strv
. It expects
the strv
 as a NULL-terminated list of strings "key:encoded_value".
The same can be returned from e_credentials_to_strv().
Since: 3.2
ECredentials * e_credentials_new_args (const gchar *key,...);
e_credentials_new_args is deprecated and should not be used in newly-written code.
Creates a new ECredentials with prefilled keys. The arguments is a NULL-terminated list of string pairs <key, value>; value is in a clear form.
Since: 3.2
ECredentials *
e_credentials_new_clone (const ECredentials *credentials);
e_credentials_new_clone is deprecated and should not be used in newly-written code.
Creates a clone (copy) of the given credentials
.
Free with e_credentials_free() when done with it. 
[transfer full]
Since: 3.2
void
e_credentials_free (ECredentials *credentials);
e_credentials_free is deprecated and should not be used in newly-written code.
Frees the credentials
. Any peek-ed values are invalidated
by this call.
Since: 3.2
gchar **
e_credentials_to_strv (const ECredentials *credentials);
e_credentials_to_strv is deprecated and should not be used in newly-written code.
Returns NULL-terminated array of strings with keys and encoded values;
To read them back pass this pointer to e_credentials_new(). As it returns
newly allocated string then this should be freed with g_strfreev() when no
longer needed.
Since: 3.2
void e_credentials_set (ECredentials *credentials,const gchar *key,const gchar *value);
e_credentials_set is deprecated and should not be used in newly-written code.
Sets value for key
, if value
 is NULL or an empty string then key
 is
removed.  The value is supposed to be in a clear form (unencoded).
key
 cannot contain colon.
Since: 3.2
gchar * e_credentials_get (const ECredentials *credentials,const gchar *key);
e_credentials_get is deprecated and should not be used in newly-written code.
A copy of the key's value, or NULL,
if no such key is stored in the credentuals
. Free returned string with
e_credentials_util_safe_free_string(), when done with it. 
[transfer full][nullable]
Since: 3.2
const gchar * e_credentials_peek (ECredentials *credentials,const gchar *key);
e_credentials_peek is deprecated and should not be used in newly-written code.
Peeks at the value for key
, in a clear form. The returned value is valid
until free of the credentials
 structure or until the key value is rewritten
by e_credentials_set().
Since: 3.2
gboolean e_credentials_equal (const ECredentials *credentials1,const ECredentials *credentials2);
e_credentials_equal is deprecated and should not be used in newly-written code.
Returns whether two ECredentials structures contain the same keys with same values.
Since: 3.2
gboolean e_credentials_equal_keys (const ECredentials *credentials1,const ECredentials *credentials2,const gchar *key1,...);
e_credentials_equal_keys is deprecated and should not be used in newly-written code.
Returns whether two ECredentials structures have the same keys. Key names are NULL-terminated.
| credentials1 | an ECredentials | |
| credentials2 | another ECredentials | |
| key1 | the first key name | |
| ... | other key names, terminated with  | 
Since: 3.2
gboolean e_credentials_has_key (const ECredentials *credentials,const gchar *key);
e_credentials_has_key is deprecated and should not be used in newly-written code.
Returns whether credentials
 contains key
.
Since: 3.2
guint
e_credentials_keys_size (const ECredentials *credentials);
e_credentials_keys_size is deprecated and should not be used in newly-written code.
Returns the number of keys in credentials
.
Since: 3.2
GSList *
e_credentials_list_keys (const ECredentials *credentials);
e_credentials_list_keys is deprecated and should not be used in newly-written code.
Returns a newly-allocated GSList of key names stored in credentials
.
The key names are internal credentials values and should not be modified
or freed.  Free the list with g_slist_free() when no longer needed.
Since: 3.2
void
e_credentials_clear (ECredentials *credentials);
e_credentials_clear is deprecated and should not be used in newly-written code.
Clears all the stored keys (and their peek-ed values).
Since: 3.2
void
e_credentials_clear_peek (ECredentials *credentials);
e_credentials_clear_peek is deprecated and should not be used in newly-written code.
Clears cache of peek-ed values.
Since: 3.2
void
e_credentials_util_safe_free_string (gchar *str);
e_credentials_util_safe_free_string is deprecated and should not be used in newly-written code.
Frees a nul-terminated string safely, which means it
overwrites the content first and only then calls g_free()
on it. If str
 is NULL, then does nothing.
Since: 3.2
gchar *
e_credentials_util_prompt_flags_to_string
                               (guint prompt_flags);
e_credentials_util_prompt_flags_to_string is deprecated and should not be used in newly-written code.
Converts bit-or of # to a string representation. Use
e_credentials_util_string_to_prompt_flags() to convert
the string back to the numeric representation.
Since: 3.2
guint
e_credentials_util_string_to_prompt_flags
                               (const gchar *prompt_flags_string);
e_credentials_util_string_to_prompt_flags is deprecated and should not be used in newly-written code.
Converts ECredentialsPromptFlags represented as string back to
the numeric representation. This is a reverse function of
e_credentials_util_prompt_flags_to_string().
Since: 3.2
struct ECredentials {
};
ECredentials is deprecated and should not be used in newly-written code.
Contains only private data that should be read and manipulated using the functions below.
Since: 3.2
#define E_CREDENTIALS_KEY_USERNAME "username"
E_CREDENTIALS_KEY_USERNAME is deprecated and should not be used in newly-written code.
FIXME Docment me.
Since: 3.2
#define E_CREDENTIALS_KEY_PASSWORD "password"
E_CREDENTIALS_KEY_PASSWORD is deprecated and should not be used in newly-written code.
FIXME Document me.
Since: 3.2
#define E_CREDENTIALS_KEY_AUTH_METHOD "auth-method"
E_CREDENTIALS_KEY_AUTH_METHOD is deprecated and should not be used in newly-written code.
FIXME Document me.
Since: 3.2
#define E_CREDENTIALS_KEY_PROMPT_TITLE "prompt-title"
E_CREDENTIALS_KEY_PROMPT_TITLE is deprecated and should not be used in newly-written code.
FIXME Document me.
Since: 3.2
#define E_CREDENTIALS_KEY_PROMPT_TEXT "prompt-text"
E_CREDENTIALS_KEY_PROMPT_TEXT is deprecated and should not be used in newly-written code.
FIXME: Document me.
Since: 3.2
#define E_CREDENTIALS_KEY_PROMPT_REASON "prompt-reason"
E_CREDENTIALS_KEY_PROMPT_REASON is deprecated and should not be used in newly-written code.
FIXME: Document me.
Since: 3.2
#define E_CREDENTIALS_KEY_PROMPT_KEY "prompt-key"
E_CREDENTIALS_KEY_PROMPT_KEY is deprecated and should not be used in newly-written code.
FIXME: Document me.
Since: 3.2
#define E_CREDENTIALS_KEY_PROMPT_FLAGS "prompt-flags"
E_CREDENTIALS_KEY_PROMPT_FLAGS is deprecated and should not be used in newly-written code.
FIXME Document me.
Since: 3.2
#define E_CREDENTIALS_KEY_FOREIGN_REQUEST "foreign-request"
E_CREDENTIALS_KEY_FOREIGN_REQUEST is deprecated and should not be used in newly-written code.
Set to "1" when the ECredentials is used to authenticate other than current EClient.
Since: 3.4
ECredentialsPromptFlags is deprecated and should not be used in newly-written code.
Flags for a credentials prompt.
| never remember the credentials | ||
| remember the credentials only for the current session | ||
| remember the credentials forever | ||
| a bit-mask of the 'remember' flags | ||
| whether hide password letters in the UI | ||
| whether this is a re-prompt | ||
| only ask if we're online | ||
| disable the 'remember password' checkbox | ||
| we are asking a passphrase | 
Since: 3.2