虚函数

Gio文件trash

声明 [源]

gboolean
trash (
  GFile* file,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

如果可能的话,将 file 放入“回收站”。这类似于删除它,但用户在清空回收站之前可以恢复它。默认情况下,系统挂载禁用垃圾处理(参见 g_unix_mount_entry_is_system_internal()),因此此调用可能返回 G_IO_ERROR_NOT_SUPPORTED 错误。自从 GLib 2.66 以来,可以使用 x-gvfs-notrash Unix 挂载选项来禁用特定挂载的 g_file_trash() 支持,此时将返回 G_IO_ERROR_NOT_SUPPORTED 错误。从 2.82 版本开始,可以使用 x-gvfs-trash Unix 挂载选项来启用针对特定系统挂载的 g_file_trash() 支持。

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

参数

cancellable

类型: GCancellable

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

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

类型: GError **

可恢复错误的返回位置。

参数可以为 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果没有错误,虚拟函数将保留对参数的初始化为 NULL
发生错误时,参数将被设置为一个新的 GError;调用者将拥有数据,并负责释放它。

返回值

类型: gboolean

垃圾处理成功则返回 TRUE,否则返回 FALSE