Synopsis#include <gio/gio.h> enum GAskPasswordFlags; enum GPasswordSave; GMountOperation; enum GMountOperationResult; GMountOperation* g_mount_operation_new (void); const char* g_mount_operation_get_username (GMountOperation *op); void g_mount_operation_set_username (GMountOperation *op, const char *username); const char* g_mount_operation_get_password (GMountOperation *op); void g_mount_operation_set_password (GMountOperation *op, const char *password); gboolean g_mount_operation_get_anonymous (GMountOperation *op); void g_mount_operation_set_anonymous (GMountOperation *op, gboolean anonymous); const char* g_mount_operation_get_domain (GMountOperation *op); void g_mount_operation_set_domain (GMountOperation *op, const char *domain); GPasswordSave g_mount_operation_get_password_save (GMountOperation *op); void g_mount_operation_set_password_save (GMountOperation *op, GPasswordSave save); int g_mount_operation_get_choice (GMountOperation *op); void g_mount_operation_set_choice (GMountOperation *op, int choice); void g_mount_operation_reply (GMountOperation *op, GMountOperationResult result); Properties"anonymous" gboolean : Read / Write "choice" gint : Read / Write "domain" gchar* : Read / Write "password" gchar* : Read / Write "password-save" GPasswordSave : Read / Write "username" gchar* : Read / Write DescriptionGMountOperation provides a mechanism for authenticating mountable operations, such as loop mounting files, hard drive partitions or server locations. Mounting operations are handed a GMountOperation that then can use if they require any privileges or authentication for their volumes to be mounted (e.g. a hard disk partition or an encrypted filesystem), or if they are implementing a remote server protocol which requires user credentials such as FTP or WebDAV. Users should instantiate a subclass of this that implements all the various callbacks to show the required dialogs, such as GtkMountOperation.
Detailsenum GAskPasswordFlagstypedef enum { G_ASK_PASSWORD_NEED_PASSWORD = (1 << 0), G_ASK_PASSWORD_NEED_USERNAME = (1 << 1), G_ASK_PASSWORD_NEED_DOMAIN = (1 << 2), G_ASK_PASSWORD_SAVING_SUPPORTED = (1 << 3), G_ASK_PASSWORD_ANONYMOUS_SUPPORTED = (1 << 4) } GAskPasswordFlags; GAskPasswordFlags are used to request specific information from the user, or to notify the user of their choices in an authentication situation.
enum GPasswordSavetypedef enum { G_PASSWORD_SAVE_NEVER, G_PASSWORD_SAVE_FOR_SESSION, G_PASSWORD_SAVE_PERMANENTLY } GPasswordSave; GPasswordSave is used to indicate the lifespan of a saved password. Gvfs stores passwords in the Gnome keyring when this flag allows it to, and later retrieves it again from there.
GMountOperationtypedef struct _GMountOperation GMountOperation; Class for providing authentication methods for mounting operations, such as mounting a file locally, or authenticating with a server.
enum GMountOperationResulttypedef enum { G_MOUNT_OPERATION_HANDLED, G_MOUNT_OPERATION_ABORTED, G_MOUNT_OPERATION_UNHANDLED } GMountOperationResult; GMountOperationResult is returned as a result when a request for information is send by the mounting operation.
g_mount_operation_new ()GMountOperation* g_mount_operation_new (void); Creates a new mount operation.
g_mount_operation_get_username ()const char* g_mount_operation_get_username (GMountOperation *op); Get the user name from the mount operation.
g_mount_operation_set_username ()void g_mount_operation_set_username (GMountOperation *op, const char *username);
Sets the user name within
g_mount_operation_get_password ()const char* g_mount_operation_get_password (GMountOperation *op); Gets a password from the mount operation.
g_mount_operation_set_password ()void g_mount_operation_set_password (GMountOperation *op, const char *password);
Sets the mount operation's password to
g_mount_operation_get_anonymous ()gboolean g_mount_operation_get_anonymous (GMountOperation *op); Check to see whether the mount operation is being used for an anonymous user.
g_mount_operation_set_anonymous ()void g_mount_operation_set_anonymous (GMountOperation *op, gboolean anonymous);
Sets the mount operation to use an anonymous user if
g_mount_operation_get_domain ()const char* g_mount_operation_get_domain (GMountOperation *op); Gets the domain of the mount operation.
g_mount_operation_set_domain ()void g_mount_operation_set_domain (GMountOperation *op, const char *domain); Sets the mount operation's domain.
g_mount_operation_get_password_save ()GPasswordSave g_mount_operation_get_password_save (GMountOperation *op); Gets the state of saving passwords for the mount operation.
g_mount_operation_set_password_save ()void g_mount_operation_set_password_save (GMountOperation *op, GPasswordSave save); Sets the state of saving passwords for the mount operation.
g_mount_operation_get_choice ()int g_mount_operation_get_choice (GMountOperation *op); Gets a choice from the mount operation.
g_mount_operation_set_choice ()void g_mount_operation_set_choice (GMountOperation *op, int choice); Sets a default choice for the mount operation.
g_mount_operation_reply ()void g_mount_operation_reply (GMountOperation *op, GMountOperationResult result); Emits the "reply" signal.
Property DetailsThe
|
|
a GMountOperation requesting a password. |
|
string containing a message to display to the user. |
|
string containing the default user name. |
|
string containing the default domain. |
|
a set of GAskPasswordFlags. |
|
user data set when the signal handler was connected. |
"ask-question"
signalvoid user_function (GMountOperation *op, gchar *message, GStrv *choices, gpointer user_data) : Run Last
Emitted when asking the user a question and gives a list of choices for the user to choose from.
|
a GMountOperation asking a question. |
|
string containing a message to display to the user. |
|
an array of strings for each possible choice. |
|
user data set when the signal handler was connected. |
"reply"
signalvoid user_function (GMountOperation *op, GMountOperationResult result, gpointer user_data) : Run Last
Emitted when the user has replied to the mount operation.
|
a GMountOperation. |
|
a GMountOperationResult indicating how the request was handled |
|
user data set when the signal handler was connected. |