Deletes the specified directory.

Function Group Execution Windows Embedded Thin Client Mobile Access
DirDelete File Synchronous Supported Supported Executed on Server Not supported


  DirDelete( strDirectory, optBooEmptyOnly )  
The name and file path of the directory to delete.
Tip: This parameter supports wildcards ( * and ? ).
Optional flag. If this parameter has a value of 1, then the directory is deleted only if it is empty. By default — that is, if the parameter is omitted or has a value of 0 — the directory is deleted whether it is empty or not.

Returned value

Value Description
−2 Attempted to delete a non-empty directory when this action is not allowed (i.e., optBooEmptyOnly does not equal 0).
−1 Invalid parameters.
0 Failed to delete the directory (i.e., directory does not exist).
1 Directory deleted successfully.


Tag Name Expression
Tag DirDelete( “C:StudioTemp” ) // The Temp folder from C:Studio is deleted.
Tag DirDelete( “C:StudioTemp”, 1 ) // The Temp folder from C:Studio is deleted only if it is empty.