方法

GioFilemonitor_directory

声明 [源]

GFileMonitor*
g_file_monitor_directory (
  GFile* file,
  GFileMonitorFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

获取给定文件的目录监视器。如果目录监控不受支持,则可能会失败。

如果cancellable不是NULL,则可以从另一个线程触发可取消对象来取消操作。如果操作已被取消,将返回错误G_IO_ERROR_CANCELLED

由于硬链接不能建立到目录中,因此将G_FILE_MONITOR_WATCH_HARD_LINKS包含在flags中是没有意义的。无法监视目录中所有文件的更改,这些更改是通过硬链接进行的;如果需要这样做,则必须使用g_file_monitor()注册单个监视器。

参数

flags

类型: GFileMonitorFlags

一组GFileMonitorFlags

cancellable

类型: GCancellable

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

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

类型: GError **

用于回收错误的位置。

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

返回值

类型: GFileMonitor

给定fileGFileMonitor,或在错误时为NULL。使用g_object_unref()释放返回的对象。

方法调用者负责返回数据的所有权,并负责释放它。