DIR$ CLOSE statement

Purpose | Force the release of the operating system FindNext handle.
Syntax | DIR$ CLOSE

Remarks

DIR$ CLOSE will cause the operating system FindNext handle to be closed. Each time a new DIR$() sequence is initiated within a thread, or DIR$() returns an empty string, PowerBASIC automatically closes the FindNext handle to avoid overuse of system resources.

However, in unusual circumstances (such as a recursive directory scan with delete or rename), it may be necessary to close the FindNext handle sooner, through the use of this explicit statement, so that a directory can be removed or renamed.

Restrictions | It is never necessary to execute DIR$ CLOSE to simply avoid a "System Handle Leak".
See also | DIR$