虚拟方法
GNOMEFileenumerate_children
声明 [源代码]
GFileEnumerator*
enumerate_children (
GFile* file,
const char* attributes,
GFileQueryInfoFlags flags,
GCancellable* cancellable,
GError** error
)
描述 [源代码]
获取目录中文件所请求的信息。返回结果是一个GFileEnumerator对象，该对象会为目录中所有文件提供GFileInfo对象。
attributes值是一个字符串，用于指定应该收集的文件属性。如果无法从文件中读取特定的请求属性，不会报错，只会不设置该属性。attributes应该是一个由逗号分隔的属性或属性通配符列表。通配符“”表示所有属性，类似“standard::”则表示标准命名空间中的所有属性。例如，一个属性查询可以是“standard::*, owner::user”。标准属性可以通过定义获取，例如G_FILE_ATTRIBUTE_STANDARD_NAME。如果你打算在返回的枚举器上调用g_file_enumerator_get_child()或g_file_enumerator_iterate()，应始终指定G_FILE_ATTRIBUTE_STANDARD_NAME。
如果cancellable不是NULL，则可以从另一个线程通过触发可取消对象来取消操作。如果操作被取消，将返回错误G_IO_ERROR_CANCELLED。
如果文件不存在，将返回错误G_IO_ERROR_NOT_FOUND。如果文件不是目录，将返回错误G_IO_ERROR_NOT_DIRECTORY。也可能有其他错误。
参数
attributes-
类型:
const char*一个属性查询字符串。
这些数据由方法调用者拥有。 该值是一个以NUL终止的UTF-8字符串。 flags-
一组
GFileQueryInfoFlags。 cancellable-
类型:
GCancellable可选的
GCancellable对象，如果为NULL则忽略。该参数可以为 NULL。这些数据由方法调用者拥有。 error-
类型:
GError **可用于保存可恢复错误的返回位置。
该参数可以为 NULL。如果返回位置不是 NULL，则必须将其初始化为NULL的GError*。如果没有错误，虚拟函数将保留该参数为 NULL初始化。如果出现错误，该参数将被设置为一个新的分配的 GError；调用者将获取数据的所有权，并负责释放它。
返回值
类型: GFileEnumerator
如果成功则为GFileEnumerator，出错时为NULL。使用g_object_unref()释放返回的对象。
| 方法的调用者将获取返回数据的所有权，并负责释放它。 |