gmime-session

Name

gmime-session -- 

Synopsis



struct      GMimeSession;
char*       g_mime_session_request_passwd   (GMimeSession *session,
                                             const char *prompt,
                                             gboolean secret,
                                             const char *item,
                                             GError **err);
void        g_mime_session_forget_passwd    (GMimeSession *session,
                                             const char *item,
                                             GError **err);
gboolean    g_mime_session_is_online        (GMimeSession *session);


Object Hierarchy


  GObject
   +----GMimeSession

Description

Details

struct GMimeSession

struct GMimeSession;


g_mime_session_request_passwd ()

char*       g_mime_session_request_passwd   (GMimeSession *session,
                                             const char *prompt,
                                             gboolean secret,
                                             const char *item,
                                             GError **err);

Requests the password for item item.

session :

session object

prompt :

prompt to present to the user

secret :

TRUE if the characters the user types should be hidden

item :

item name

err :

exception

Returns :

a string buffer containing the password for the requested item or NULL on fail.


g_mime_session_forget_passwd ()

void        g_mime_session_forget_passwd    (GMimeSession *session,
                                             const char *item,
                                             GError **err);

Forgets the password for item item.

session :

session object

item :

item name

err :

exception


g_mime_session_is_online ()

gboolean    g_mime_session_is_online        (GMimeSession *session);

Gets whether or not the session is 'online' or not (online meaning that we are connected to the internet).

session :

session object

Returns :

TRUE if the session is online or FALSE otherwise.