方法

GioFilequery_settable_attributes

声明 [源]

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

描述 [源]

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

返回在此文件上可以设置的属性的类型和完整属性名称。但这并不意味着设置总会成功，你可能遇到访问失败，或者某些特定文件可能不支持特定的属性。

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

参数

cancellable

类型: GCancellable

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

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

类型: GError **

可恢复错误的返回位置。

该参数可以为 NULL。
如果返回位置不是 NULL，那么你必须将它初始化为一个空白的 GError*。
如果没有错误，方法将保留对参数的初始化为 NULL。
如果发生错误，参数将被设置为一个新的 GError；调用者将负责拥有这些数据，并负责释放它。

返回值

类型: GFileAttributeInfoList

描述可设置属性的 GFileAttributeInfoList。在完成使用后，使用 g_file_attribute_info_list_unref() 释放它。

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