DeleteFileA 函数（fileapi.h）

删除现有文件。

若要将此操作作为事务处理操作执行，请使用 DeleteFileTransacted 函数。

语法

BOOL DeleteFileA(
  [in] LPCSTR lpFileName
);

[in] lpFileName

要删除的文件的名称。

默认情况下，名称限制为MAX_PATH个字符。若要将此限制扩展到 32,767 宽字符，请将“\\？\”前面追加到路径。有关详细信息，请参阅命名文件、路径和命名空间。

提示

从 Windows 10 版本 1607 开始，你可以选择加入以删除MAX_PATH限制，而无需追加“\\？\”。有关详细信息，请参阅命名文件、路径和命名空间的“最大路径长度限制”部分。

如果函数成功，则返回值为非零。

如果函数失败，则返回值为零（0）。若要获取扩展的错误信息，请调用 GetLastError。

如果应用程序尝试删除不存在的文件，DeleteFile 函数将失败并 ERROR_FILE_NOT_FOUND。如果文件是只读文件，则函数将失败并 ERROR_ACCESS_DENIED。

以下列表标识了删除、删除或关闭文件的一些提示：

如果设置了除删除和删除子级以外的所有访问权限的目录，并且继承了新文件的访问控制列表（ACL），则可以创建一个文件，而无需删除它。但是，可以创建一个文件，然后在创建文件时返回的句柄上获取请求的所有访问权限。

如果在创建文件时请求删除权限，则可以使用该句柄删除或重命名文件，但不能使用任何其他句柄来删除或重命名该文件。有关详细信息，请参阅文件安全和访问权限。

如果应用程序尝试删除其他句柄为正常 I/O 或内存映射文件打开的其他句柄的文件（FILE_SHARE_DELETE 必须在打开其他句柄时指定），则 DeleteFile 函数将失败。

DeleteFile 函数将文件标记为关闭时要删除。因此，在关闭文件的最后一个句柄之前，不会删除文件。后续调用 CreateFile 打开文件时失败，ERROR_ACCESS_DENIED。

使用 POSIX 删除会导致文件在句柄保持打开状态时被删除。后续调用 CreateFile 打开文件时失败，ERROR_FILE_NOT_FOUND。

符号链接行为：

如果路径指向符号链接，则删除符号链接，而不是目标。若要删除目标，必须调用 CreateFile 并指定 FILE_FLAG_DELETE_ON_CLOSE。

在 Windows 8 和 Windows Server 2012 中，以下技术支持此函数：

注意

fileapi.h 标头将 DeleteFile 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。