方法

GioFileset_attribute

声明 [src]

gboolean
g_file_set_attribute (
  GFile* file,
  const char* attribute,
  GFileAttributeType type,
  gpointer value_p,
  GFileQueryInfoFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

在文件中设置属性名为 attribute 的属性值为 value_p

某些属性可以通过将 type 设置为 G_FILE_ATTRIBUTE_TYPE_INVALID 并将 value_p 设置为 NULL 来取消设置。

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

参数

attribute

类型: const char*

包含属性名称的字符串。

数据由方法的调用者所有。
值是NUL终止的UTF-8字符串。
type

类型: GFileAttributeType

属性的类型。

value_p

类型: gpointer

值(如果类型是指针类型,则本身是指针)的指针。

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

类型: GFileQueryInfoFlags

一组 GFileQueryInfoFlags

cancellable

类型: GCancellable

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

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

类型: GError **

用于 可恢复错误 的返回位置。

参数可以是 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果没有错误,则方法将保留初始化到 NULL 的参数。
如果在出现错误的情况下,则将参数设置为一个新的 GError;调用者将对数据进行所有者权限,并负责释放它。

返回值

类型: gboolean

TRUE 如果设置属性,否则为 FALSE