虚拟方法

GioFilequery_settable_attributes

声明 [源代码]

GFileAttributeInfoList*
query_settable_attributes (
  GFile* file,
  GCancellable* cancellable,
  GError** error
)

描述 [源代码]

获取文件的设置属性列表。

返回该文件可以设置的所有属性的类型和完整属性名。但这并不意味着设置一定会成功,可能会遇到访问失败,或者某些特定文件可能不支持某些属性。

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

参数

cancellable

类型: GCancellable

可选的 GCancellable 对象,NULL 为忽略。

该参数可以是 NULL
数据由该方法调用者所有。
error

类型: GError **

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

该参数可以是 NULL
如果返回位置不是 NULL,那么您必须将其初始化为 NULL GError
如果没有错误,虚拟函数将保留参数初始化为 NULL
如果出现错误,参数将被设置为一个新的 GError;调用者将接管数据,并负责释放它。

返回值

类型: GFileAttributeInfoList

一个 GFileAttributeInfoList,描述了可设置的属性。完成使用后,使用 g_file_attribute_info_list_unref() 释放它。

该方法的调用者接管返回的数据,并负责释放它。