GnomeVFSCancellation * gnome_vfs_cancellation_new (
Create a new GnomeVFSCancellation object for reporting cancellation to a gnome-vfs module.
void gnome_vfs_cancellation_destroy (
void gnome_vfs_cancellation_cancel (
Send a cancellation request through
If called on a different thread than the one handling idle
callbacks, there is a small race condition where the
operation finished callback will be called even if you
cancelled the operation. Its the apps responsibility
to handle this. See
gnome_vfs_async_cancel() for more
discussion about this.
gboolean gnome_vfs_cancellation_check (
Check for pending cancellation.
TRUE if the operation should be interrupted.
void gnome_vfs_cancellation_ack (
Acknowledge a cancellation. This should be called if
TRUE or if
select() reports that
input is available on the file descriptor returned by
gint gnome_vfs_cancellation_get_fd (
Get a file descriptor -based notificator for
receives a cancellation request, a character will be made
available on the returned file descriptor for input.
This is very useful for detecting cancellation during I/O operations: you
can use the
select() call to check for available input/output on the file
you are reading/writing, and on the notificator's file descriptor at the
same time. If a data is available on the notificator's file descriptor, you
know you have to cancel the read/write operation.