Similar to query_info, but obtains information about the filesystem the this is on, rather than the file itself.
For instance the amount of space available and the type of the filesystem.
The attributes
value is a string that specifies the attributes that should be gathered. It is not an error if it's not
possible to read a particular requested attribute from a file - it just won't be set. attributes
should be a comma-separated
list of attributes or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "filesystem::*" means all attributes
in the filesystem namespace. The standard namespace for filesystem attributes is "filesystem". Common attributes of interest are
FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem
in bytes), FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes
available), and FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the
filesystem).
If cancellable
is not null, then the operation can be cancelled by triggering
the cancellable object from another thread. If the operation was cancelled, the error
g_io_error_cancelled will be returned.
If the file does not exist, the g_io_error_not_found error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on.
this |
input File |
attributes |
an attribute query string |
cancellable |
optional Cancellable object, null to ignore |
a FileInfo or null if there was an error. Free the returned object with unref. |