虚拟方法
GioFilemonitor_file
声明 [src]
GFileMonitor*
monitor_file (
GFile* file,
GFileMonitorFlags flags,
GCancellable* cancellable,
GError** error
)
描述 [src]
获取给定文件的文件监视器。如果没有文件通知机制存在,则使用常规轮询文件。
如果 cancellable
不是 NULL
,则可以通过从另一个线程触发可取消对象来取消操作。如果操作被取消,将返回错误 G_IO_ERROR_CANCELLED
。
如果 flags
包含 G_FILE_MONITOR_WATCH_HARD_LINKS
,则监视器还会尝试通过其他文件名(即,一个硬链接)报告对文件的更改。不使用此标志,您只能依赖于通过 file
中的文件名进行的更改来报告。使用此标志可能会导致资源使用增加,并且可能根据 GFileMonitor
后端和/或文件系统类型而没有任何影响。
参数
flags
-
一组
GFileMonitorFlags
。 cancellable
-
类型:
GCancellable
可选的
GCancellable
对象,NULL
不处理。参数可以是 NULL
。数据由方法调用者拥有。 error
-
类型:
GError **
可恢复错误的返回位置。
参数可以是 NULL
。如果返回位置非 NULL
,则必须将其初始化为NULL
的GError
*。如果虚拟函数没有错误,参数将保留初始化为 NULL
。发生错误时,参数将设置为新分配的 GError
;调用者将拥有数据,并负责释放它。
返回值
类型: GFileMonitor
给定 file
的 GFileMonitor
,在错误情况下为 NULL
。用 g_object_unref() 释放返回的对象。
方法调用者拥有返回数据,并负责释放它。 |