![]() |
![]() |
![]() |
Reference Manual of the tinymail framework | ![]() |
---|---|---|---|---|
TnyPasswordGetter; TnyPasswordGetterIface; const gchar* tny_password_getter_get_password (TnyPasswordGetter *self, const gchar *aid, const gchar *prompt, gboolean *cancel); void tny_password_getter_forget_password (TnyPasswordGetter *self, const gchar *aid);
typedef struct { GTypeInterface parent; const gchar* (*get_password_func) (TnyPasswordGetter *self, const gchar *aid, const gchar *prompt, gboolean *cancel); void (*forget_password_func) (TnyPasswordGetter *self, const gchar *aid); } TnyPasswordGetterIface;
const gchar* tny_password_getter_get_password (TnyPasswordGetter *self, const gchar *aid, const gchar *prompt, gboolean *cancel);
Get the password of self
identified by aid
. If you set the by reference
boolean cancel
to TRUE, the caller (who requested the password) will see
this as a negative answer (For example when the user didn't know the password,
and therefore pressed a cancel button).
The aid
string can be used for so called password stores. It will contain
a unique string. Possible values of this string are "acap.server.com" or the
result of a tny_account_get_id.
self : |
a TnyPasswordGetter object |
aid : |
a unique string identifying the requested password |
prompt : |
A human-readable password question, possibly containing an untranslated error message directly from the server. This should be ignored by most implementations, so NULL is an acceptable value. |
cancel : |
whether or not the user cancelled |
Returns : | the password |
void tny_password_getter_forget_password (TnyPasswordGetter *self, const gchar *aid);
Forget the password in self
identified by aid
.
self : |
a TnyPasswordGetter object |
aid : |
a unique string identifying the requested password |