![]() | ![]() | ![]() | GnomeVFS - Filesystem Abstraction library | ![]() |
---|
Cancellation — halt in-progress operations
GnomeVFSCancellation * gnome_vfs_cancellation_new (void);void gnome_vfs_cancellation_destroy (GnomeVFSCancellation *cancellation);void gnome_vfs_cancellation_cancel (GnomeVFSCancellation *cancellation);gboolean gnome_vfs_cancellation_check (GnomeVFSCancellation *cancellation);void gnome_vfs_cancellation_ack (GnomeVFSCancellation *cancellation);gint gnome_vfs_cancellation_get_fd (GnomeVFSCancellation *cancellation);
GnomeVFSCancellation * gnome_vfs_cancellation_new (void);
Create a new GnomeVFSCancellation object for reporting cancellation to a GNOME VFS module.
Returns : | A pointer to the new GnomeVFSCancellation object. |
void gnome_vfs_cancellation_destroy (GnomeVFSCancellation *cancellation);
Destroy cancellation.
cancellation : | A GnomeVFSCancellation object |
void gnome_vfs_cancellation_cancel (GnomeVFSCancellation *cancellation);
Send a cancellation request through cancellation. Must be called on the main thread.
cancellation : | A GnomeVFSCancellation object |
gboolean gnome_vfs_cancellation_check (GnomeVFSCancellation *cancellation);
Check for pending cancellation.
cancellation : | A GnomeVFSCancellation object |
Returns : | TRUE if the operation should be interrupted. |
void gnome_vfs_cancellation_ack (GnomeVFSCancellation *cancellation);
Acknowledge a cancellation. This should be called if
`gnome_vfs_cancellation_check()' returns TRUE or if `
cancellation : | A GnomeVFSCancellation object |
gint gnome_vfs_cancellation_get_fd (GnomeVFSCancellation *cancellation);
Get a file descriptor -based notificator for cancellation. When cancellation 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 `
cancellation : | A GnomeVFSCancellation object |
Returns : | the notificator's file descriptor, or -1 if starved of file descriptors. |
<< Monitoring | File Transfers >> |