方法

GioFilebuild_attribute_list_for_copy

自：2.68

声明 [src]

char*
g_file_build_attribute_list_for_copy (
  GFile* file,
  GFileCopyFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

准备用于复制到 file 的文件属性查询字符串。

此函数准备了一个属性查询字符串，用于传递给 g_file_query_info() 以获取通常与文件一起复制的属性列表（请参阅 g_file_copy_attributes() 获取详细描述）。此函数用于 g_file_copy_attributes() 的实现，当需要分两个阶段查询和设置属性时很有用（例如，用于递归移动目录）。

自：2.68

参数

标志

类型： GFileCopyFlags

一组 GFileCopyFlags。

cancellable

类型： GCancellable

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

该参数可以是 NULL。

数据由方法调用者所有。

错误

类型： GError **

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

该参数可以是 NULL。

如果返回位置不为 NULL，则您必须将其初始化为 NULL 的 GError*。

如果没有错误，则方法将保留初始化参数为 NULL。

如果发生错误，则将参数设置为新建的 GError；调用者将获取数据所有者，并负责释放它。

返回值

类型： char*

用于 g_file_query_info() 的属性查询字符串，或在发生错误时为 NULL。

方法调用者获取返回数据的所有者，并负责释放它。

该值是一个以 NUL 结束的 UTF-8 字符串。