Locating Standard Directories

Locating Standard Directories — Utilities for locating standard directories such as the desktop and trash

Synopsis




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

Description

Details

enum GnomeVFSFindDirectoryKind

typedef enum {
	GNOME_VFS_DIRECTORY_KIND_DESKTOP = 1000,
	GNOME_VFS_DIRECTORY_KIND_TRASH = 1001
} GnomeVFSFindDirectoryKind;

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);
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 : If we don't know where trash is yet, look for it.
permissions : If creating, use these permissions
Returns : An integer representing the result of the operation