方法

GioFileset_attribute_byte_string

声明 [源]

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

描述 [源]

将类型为 G_FILE_ATTRIBUTE_TYPE_BYTE_STRINGattribute 设置为 value。如果 attribute 是不同类型,此操作将失败,返回 FALSE

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

参数

attribute

类型: const char*

包含属性名称的字符串。

数据由方法的调用者拥有。
值是空终止的UTF-8字符串。
value

类型: const char*

包含属性新值的字符串。

数据由方法的调用者拥有。
值是空终止的UTF-8字符串。
flags

类型: GFileQueryInfoFlags

一个 GFileQueryInfoFlags

cancellable

类型: GCancellable

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

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

类型: GError **

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

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

返回值

类型: gboolean

如果已成功在文件中将 attribute 设置为 value,则返回 TRUE,否则返回 FALSE