Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter SixFile Functions (continued)

RecycleFile Function

Overview

The RecycleFile function places the specified file or folder and its contents in the recycle bin if possible. If the file or folder cannot be recycled, it is deleted.

Syntax/Parameters

Syntax

int = RecycleFile ( string target );

Parameters

string

A string containing a fully qualified path and filename. This parameter supports UTF encoding for filenames with Unicode characters.

Return Value

Returns an int as ERROR_NONE on success or a formatted error code on failure. Note that the underlying Windows error code does not use the standard error code but rather returns Windows shell error codes. See MSDN SHFileOperation for additional details.

Remarks

The RecycleFile function will behave like the DeleteFile function if the volume on which the file specified by the name parameter is located does not support recycling. This function only works on certain Windows file systems; using it on a file located on the VFC will delete the file.

If the item is too large for the recycle bin, it will be deleted.

The RecycleFile will also allow folders and subfolders to be deleted.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic

Page revised 2024-12-13