方法
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
-
属性的类型。
value_p
-
类型:
gpointer
值(如果类型是指针类型,则本身是指针)的指针。
参数可以是 NULL
。数据由方法的调用者所有。 flags
-
一组
GFileQueryInfoFlags
。 cancellable
-
类型:
GCancellable
可选的
GCancellable
对象,NULL
表示忽略。参数可以是 NULL
。数据由方法的调用者所有。 error
-
类型:
GError **
用于 可恢复错误 的返回位置。
参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,则方法将保留初始化到 NULL
的参数。如果在出现错误的情况下,则将参数设置为一个新的 GError
;调用者将对数据进行所有者权限,并负责释放它。