get_password

This function is used by a Service to ask the application and the user for a password or other authentication data.

service and item together uniquely identify the piece of data the caller is concerned with.

prompt is a question to ask the user (if the application doesn't already have the answer cached). If camel_session_password_secret is set, the user's input will not be echoed back.

If camel_session_password_static is set, it means the password returned will be stored statically by the caller automatically, for the current session.

The authenticator should set throws to g_io_error_cancelled if the user did not provide the information. The caller must g_free the information returned when it is done with it.

Parameters:

this	a Session
service	the Service this query is being made by
prompt	prompt to provide to user
item	an identifier, unique within this service, for the information
flags	camel_session_password_reprompt, the prompt should force a reprompt camel_session_password_secret, whether the password is secret camel_session_password_static, the password is remembered externally

Returns:

the authentication information or null on error