虚拟方法

GioFilequery_filesystem_info

声明 [源]

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

描述 [源]

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

参数 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*

一个属性查询字符串。

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

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

cancellable

类型: GCancellable

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

该参数可以为 NULL。

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

error

类型: GError **

恢复性错误的返回位置。关于 GError 的使用规则。

该参数可以为 NULL。

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

如果虚拟函数没有错误，则参数将初始化为 NULL。

在出错情况下，参数将设置为一个新的 GError；调用者将拥有数据，并负责释放它。

返回值

类型: GFileInfo

GFileInfo 或 NULL 如果有错误。使用 g_object_unref() 释放返回的对象。

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