方法

gioFilequery_filesystem_info

声明 [源]

GFileInfo*
g_file_query_filesystem_info (
  GFile* file,
  const char* attributes,
  GCancellable* cancellable,
  GError** error
)

说明 [源]

类似于 g_file_query_info()，但它获取 file 所在文件系统的信息，而不是文件本身的信息。例如，可用空间量和文件系统的类型。

attributes 的值是一个字符串，指定应收集的属性。如果无法从一个文件中读取请求的特定属性，则不会是错误 - 它只是不会被设置。《code>attributes 应该是一个属性或属性通配符的逗号分隔列表。通配符 “” 表示所有属性，通配符如 “filesystem::” 表示文件系统命名空间中的所有属性。文件系统属性的常规命名空间是“filesystem”。有趣的常见属性包括 G_FILE_ATTRIBUTE_FILESYSTEM_SIZE（文件系统的总大小，以字节为单位），G_FILE_ATTRIBUTE_FILESYSTEM_FREE（可用的字节数）和 G_FILE_ATTRIBUTE_FILESYSTEM_TYPE（文件系统的类型）。

如果 cancellable 不是 NULL，则可以取消操作通过从另一个线程触发可取消对象。如果操作被取消，将返回错误 G_IO_ERROR_CANCELLED。

如果文件不存在，将返回 G_IO_ERROR_NOT_FOUND 错误。也可能出现其他错误，具体取决于文件所在的文件系统类型。

参数

attributes

类型： const char*

一个属性查询字符串。

数据由方法的调用者拥有。

该值是一个以 NUL 结尾的 UTF-8 字符串。

cancellable

类型： GCancellable

可选的 GCancellable 对象，NULL 表示忽略。

该参数可以为 NULL。

数据由方法的调用者拥有。

error

类型： GError **

一个可恢复错误的返回位置。

该参数可以为 NULL。

如果返回位置不是 NULL，则必须将其初始化为 NULL GError*。

如果没有错误，方法将保留初始化的 NULL。

在出现错误的情况下，该参数将被设置为一个新的 GError；调用者将负责获取数据并释放它。

返回值

类型： GFileInfo

一个 GFileInfo 对象或如果发生错误则为 NULL。使用 g_object_unref() 释放返回的对象。

方法的调用者将拥有返回的数据，并负责释放它。