方法

GioFiletrash

声明 [src]

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

描述 [src]

如果可能，将 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。