Find Directory

Name

Find Directory -- used to locate special directories such as the trash and desktop

Synopsis



GnomeVFSResult gnome_vfs_find_directory     (GnomeVFSURI *near_uri,
                                             GnomeVFSFindDirectoryKind kind,
                                             GnomeVFSURI **result,
                                             gboolean create_if_needed,
                                             gboolean find_if_needed,
                                             guint permissions);

Description

Details

gnome_vfs_find_directory ()

GnomeVFSResult gnome_vfs_find_directory     (GnomeVFSURI *near_uri,
                                             GnomeVFSFindDirectoryKind kind,
                                             GnomeVFSURI **result,
                                             gboolean create_if_needed,
                                             gboolean find_if_needed,
                                             guint permissions);

Used to return well known directories such as Trash, Desktop, etc. from different file systems.

There is quite a complicated logic behind finding/creating a Trash directory and you need to be aware of some implications: Finding the Trash the first time when using the file method may be pretty expensive. A cache file is used to store the location of that Trash file for next time. If ceate_if_needed is specified without find_if_needed, you may end up creating a Trash file when there already is one. Your app should start out by doing a gnome_vfs_find_directory with the find_if_needed to avoid this and then use the create_if_needed flag to create Trash lazily when it is needed for throwing away an item on a given disk.

near_uri : find a well known directory on the same volume as near_uri
kind : kind of well known directory
result : newly created URI of the directory we found
create_if_needed : If directory we are looking for does not exist, try to create it
find_if_needed : 
permissions : If creating, use these permissions
Returns : An integer representing the result of the operation