Deletes a file from its medium.

BOOLEAN RemoveRtFile(
    LPSTR lpFileName);

Parameters

lpFileName

The name of the file to be removed.

Remarks

If an application attempts to delete a file that does not exist, the DeleteRtFile RemoveRtFile function fails with E_FNEXIST.

If the file is a read-only file, the function fails with E_FACCESS. If a file is currently open then the deletion does not actually take place until the file is closed (the file handle is deleted).

To delete an empty directory, use the RemoveRtDirectory function.

Return values

Returns TRUE on success. On failure returns FALSE and the status code may be obtained from GetLastRtError.

Requirements