RemoveDirectory

RemoveDirectory deletes an existing empty directory.

Syntax

BOOL RemoveDirectory(
    [in]    LPCTSTR lpPathName
);

Parameters

[in] lpPathName

A pointer to a null-terminated string that specifies the path of the directory to be removed. The path must specify an empty directory, and the calling process must have delete access to the directory.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. Call GetLastError to get extended error information.

Remarks

RemoveDirectory does not delete any object identified by lpPathName.

Filesystem APIs only support absolute path names. If a relative or simple path name is passed into the function, it will return ERROR_PATH_NOT_FOUND.

Requirements

See Also:

• CreateDirectory