方法
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_STRING
的 attribute
属性设置为 value
。如果 attribute
不是该类型,则此操作将失败。
如果 cancellable
不是 NULL
,则可以由另一个线程触发可取消对象来取消操作。如果操作被取消,将返回错误 G_IO_ERROR_CANCELLED
。
参数
attribute
-
类型:
const char*
包含属性名称的字符串。
数据由方法调用者拥有。 该值是一个以 NUL终止的 UTF-8 字符串。 value
-
类型:
const char*
包含属性值的字符串。
数据由方法调用者拥有。 该值是一个以 NUL终止的 UTF-8 字符串。 flags
-
GFileQueryInfoFlags
. cancellable
-
类型:
GCancellable
可选的
GCancellable
对象,为NULL
时忽略。该参数可以为 NULL
。数据由方法调用者拥有。 error
-
类型:
GError **
用于可恢复错误的返回位置。
该参数可以为 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,方法将使该参数保持初始化为 NULL
。在发生错误的情况下,该参数将设置为一个新的 GError
;调用者将负责拥有该数据,并负责释放它。