方法

Gi文件set_attribute_string

声明 [src]

gboolean
g_file_set_attribute_string (
  GFile* file,
  const char* attribute,
  const char* value,
  GFileQueryInfoFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

将类型为 G_FILE_ATTRIBUTE_TYPE_STRINGattribute 属性设置为 value。如果 attribute 不是该类型,则此操作将失败。

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

参数

attribute

类型: const char*

包含属性名称的字符串。

数据由方法调用者拥有。
该值是一个以 NUL终止的 UTF-8 字符串。
value

类型: const char*

包含属性值的字符串。

数据由方法调用者拥有。
该值是一个以 NUL终止的 UTF-8 字符串。
flags

类型: GFileQueryInfoFlags

GFileQueryInfoFlags.

cancellable

类型: GCancellable

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

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

类型: GError **

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

该参数可以为 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果没有错误,方法将使该参数保持初始化为 NULL
在发生错误的情况下,该参数将设置为一个新的 GError;调用者将负责拥有该数据,并负责释放它。

返回值

类型: gboolean

如果成功设置 attribute,则为 TRUE,否则为 FALSE