DeleteFile 函数 (winbase.h)
发布时间:2026-08-20 | 浏览:1
访问此页面需要授权。 可以尝试 登录 或 更改目录 。
访问此页面需要授权。 可以尝试 更改目录 。
若要将此作作为事务处理作执行,请使用 DeleteFileTransacted 函数。
[in] lpFileName
默认情况下,名称限制为MAX_PATH个字符。 若要将此限制扩展到 32,767 宽字符,请将“\\?\”前面追加到路径。 有关详细信息,请参阅 命名文件、路径和命名空间 。
从 Windows 10 版本 1607 开始,你可以选择加入以删除MAX_PATH限制,而无需追加“\\?\”。 有关详细信息,请参阅 命名文件、路径和命名空间 的“最大路径长度限制”部分。
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零(0)。 若要获取扩展的错误信息,请调用 GetLastError 。
如果应用程序尝试删除不存在的文件, 则 DeleteFile 函数将失败并 ERROR_FILE_NOT_FOUND 。 如果文件是只读文件,则函数会失败并 ERROR_ACCESS_DENIED 。
以下列表标识了删除、删除或关闭文件的一些提示:
若要删除只读文件,首先必须删除只读属性。
若要删除或重命名文件,必须对文件具有删除权限,或者删除父目录中的子权限。
若要以递归方式删除目录中的文件,请使用 SHFileOperation 函数。
若要删除空目录,请使用 RemoveDirectory 函数。
若要关闭打开的文件,请使用 CloseHandle 函数。
如果在创建文件时请求删除权限,则可以使用该句柄删除或重命名文件,但不能使用任何其他句柄来删除或重命名该文件。 有关详细信息,请参阅 文件安全性和访问权限 。
如果应用程序尝试删除 具有未打开 FILE_SHARE_DELETE或内存映射的其他打开句柄的文件, DeleteFile 函数将失败。
DeleteFile 函数在关闭时标记要删除的文件。 因此,在关闭文件的最后一个句柄之前,不会删除文件。 后续调用 CreateFile 以打开文件 失败,ERROR_ACCESS_DENIED 。
如果路径指向符号链接,则删除符号链接,而不是目标。 若要删除目标,必须调用 CreateFile 并指定 FILE_FLAG_DELETE_ON_CLOSE 。
在 Windows 8 和 Windows Server 2012 中,以下技术支持此函数。
有关示例,请参阅 “锁定和解锁文件中的字节范围 ”。
DeleteFileTransacted
想要尝试使用 Ask Learn 阐明或指导你完成本主题?
Last updated on 2026-05-21