gnome-vfs-module-callback-module-api

gnome-vfs-module-callback-module-api — invoking callbacks from a gnome-vfs module to ask the application for necessary information (authentication, ...)

Synopsis




gboolean    gnome_vfs_module_callback_invoke
                                            (const char *callback_name,
                                             gconstpointer in,
                                             gsize in_size,
                                             gpointer out,
                                             gsize out_size);

Description

Details

gnome_vfs_module_callback_invoke ()

gboolean    gnome_vfs_module_callback_invoke
                                            (const char *callback_name,
                                             gconstpointer in,
                                             gsize in_size,
                                             gpointer out,
                                             gsize out_size);

Invoke a default callback for callback_name, with in arguments specified by in and in_size, and out arguments specified by out and out_size.

This function should only be called by gnome-vfs modules.

If this function is called from an async job thread, it will invoke the current async handler for callback_name, if any. If no async handler is set, or the function is not called from an async job thread, the regular handler, if any, will be invoked instead. If no handler at all is found for callback_name, the function returns FALSE.

callback_name : name of the module callback to set.
in : in argument for this callback; the exact type depends on the specific callback.
in_size : size of the in argument; useful for sanity-checking.
out : out argument for this callback; the exact type depends on the specific callback.
out_size : size of the out argument; useful for sanity-checking.
Returns : TRUE if a callback was invoked, FALSE if none was set.