gmime-session-simple

gmime-session-simple —

Synopsis




            GMimeSessionSimple;
void        g_mime_session_simple_set_request_passwd
                                            (GMimeSessionSimple *session,
                                             GMimeSimpleRequestPasswdFunc request_passwd);
void        g_mime_session_simple_set_forget_passwd
                                            (GMimeSessionSimple *session,
                                             GMimeSimpleForgetPasswdFunc forget_passwd);
void        g_mime_session_simple_set_is_online
                                            (GMimeSessionSimple *session,
                                             GMimeSimpleIsOnlineFunc is_online);


Object Hierarchy


  GObject
   +----GMimeSession
         +----GMimeSessionSimple

Description

Details

GMimeSessionSimple

typedef struct _GMimeSessionSimple GMimeSessionSimple;


g_mime_session_simple_set_request_passwd ()

void        g_mime_session_simple_set_request_passwd
                                            (GMimeSessionSimple *session,
                                             GMimeSimpleRequestPasswdFunc request_passwd);

Sets the request_passwd callback function on the simple session object. request_passwd should return a malloc'd string containing the password that the user entered or NULL on fail as well as setting the 'err' argument. The 'item' argument can be used as a unique key identifier if request_passwd decides to cache the passwd. The 'prompt' argument should be used as the string to display to the user requesting the passwd. Finally, 'secret' should be used to determine whether or not to hide the user's input.

session : Simple Session object
request_passwd : callback to prompt the user for a passwd

g_mime_session_simple_set_forget_passwd ()

void        g_mime_session_simple_set_forget_passwd
                                            (GMimeSessionSimple *session,
                                             GMimeSimpleForgetPasswdFunc forget_passwd);

Sets the forget_passwd callback function on the simple session object. forget_passwd should uncache the passwd for 'item'. See g_mime_session_simple_set_request_passwd() for further details.

session : Simple Session object
forget_passwd : callback to forget the cached passwd keyed for 'item'

g_mime_session_simple_set_is_online ()

void        g_mime_session_simple_set_is_online
                                            (GMimeSessionSimple *session,
                                             GMimeSimpleIsOnlineFunc is_online);

Sets the is_online callback function on the simple session object. is_online should return TRUE if the network is reachable or FALSE otherwise.

session : Simple Session object
is_online : callback to return if the system is connected to the 'net