Name
Standard Callbacks -- module callbacks pre-defined by gnome-vfs
Description
Some standard module callbacks are predefined. They include callbacks
for authentication, http proxy authentication, and status
messages. For each standard callback, a macro provides the name, and
structures are defined for the in and out argument.
Details
GNOME_VFS_MODULE_CALLBACK_AUTHENTICATION
#define GNOME_VFS_MODULE_CALLBACK_AUTHENTICATION "simple-authentication" |
This callback is called when access to a URI requires a username and
password.
GNOME_VFS_MODULE_CALLBACK_HTTP_PROXY_AUTHENTICATION
#define GNOME_VFS_MODULE_CALLBACK_HTTP_PROXY_AUTHENTICATION "http:proxy-authentication" |
This callback is called when access to an HTTP proxy requires a
username and password.
GnomeVFSModuleCallbackAuthenticationOut
typedef struct {
char *username; /* will be freed by g_free,
* NULL indicates no auth should be provided;
* if the request requires authn, the operation
* will fail with a GNOME_VFS_ERROR_ACCESS_DENIED
* code
*/
char *password; /* will be freed by g_free */
/* Reserved "padding" to avoid future breaks in ABI compatibility */
void *reserved1;
void *reserved2;
} GnomeVFSModuleCallbackAuthenticationOut; |
GNOME_VFS_MODULE_CALLBACK_STATUS_MESSAGE
#define GNOME_VFS_MODULE_CALLBACK_STATUS_MESSAGE "status-message" |
This callback is called when a GnomeVFS module operation has a status
message to return to the application.
GnomeVFSModuleCallbackStatusMessageIn
typedef struct {
char *uri; /* Full URI of operation */
char *message; /* A message indicating the current state or
* NULL if there is no message */
int percentage; /* Percentage indicating completeness 0-100 or
* -1 if there is no progress percentage to
* report */
/* Reserved "padding" to avoid future breaks in ABI compatibility */
void *reserved1;
void *reserved2;
} GnomeVFSModuleCallbackStatusMessageIn; |
GnomeVFSModuleCallbackStatusMessageOut
typedef struct {
int dummy; /* empty structs not allowed */
/* Reserved "padding" to avoid future breaks in ABI compatibility */
void *reserved1;
void *reserved2;
} GnomeVFSModuleCallbackStatusMessageOut; |