Sends a file or directory to the recycle bin if possible, or permanently deletes it.
FileRecycle, FilePattern
The name of a single file or a wildcard pattern such as C:\Temp\*.tmp. FilePattern is assumed to be in %A_WorkingDir% if an absolute path isn't specified.
To recycle an entire directory, provide its name without a trailing backslash.
[v1.1.04+]: This command is able to throw an exception on failure. For more information, see Runtime Errors.
ErrorLevel is set to 1 if there was a problem or 0 otherwise.
SHFileOperation is used to do the actual work. This function may permanently delete the file if it is too large to be recycled; as of [v1.0.96], a warning should be shown before this occurs.
The file may be permanently deleted without warning if the file cannot be recycled for other reasons, such as:
NukeOnDelete registry value.FileRecycleEmpty, FileDelete, FileCopy, FileMove