DeleteFile

DeleteFile deletes an existing file.

Syntax

BOOL DeleteFile(
    LPCTSTR lpFileName
);

Parameters

lpFileName

Points to a null-terminated string that specifies the file to be deleted.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE.

To get extended error information, call GetLastError.

Remarks

If an application attempts to delete a file that does not exist, the DeleteFile function fails.

The DeleteFile function fails if an application attempts to delete a file that is open for normal I/O or as a memory-mapped file.

To close an open file, use the RtCloseHandle function.

Requirements

See Also:

• CreateFile