通过

zwDeleteFile 函数 (ntifs.h)

  • 项目

ZwDeleteFile 例程删除指定的文件。

语法

NTSYSAPI NTSTATUS ZwDeleteFile(
  [in] POBJECT_ATTRIBUTES ObjectAttributes
);

参数

[in] ObjectAttributes

指向 OBJECT_ATTRIBUTES 结构的指针，该结构包含调用方提供用于文件对象的属性。 例如，这些属性将包括 ObjectName 和 SECURITY_DESCRIPTOR。 此参数通过调用 InitializeObjectAttributes 宏进行初始化。

返回值

ZwDeleteFile 返回STATUS_SUCCESS或相应的错误状态，表示操作的最终完成状态。 可能的错误状态代码包括：

返回代码 说明
STATUS_INSUFFICIENT_RESOURCES 无法分配此函数所需的临时缓冲区。
STATUS_INVALID_PARAMETER 指定的 ObjectAttributes 参数是 NULL 指针，不是指向 OBJECT_ATTRIBUTES 结构的有效指针，或者某些指定的 ObjectAttributes 结构成员无效。
STATUS_OBJECT_NAME_INVALID ObjectAttributes 参数在 OBJECT_ATTRIBUTES 结构中包含一个无效的 ObjectName，因为在OBJECT_NAME_PATH_SEPARATOR字符之后找到了空字符串。
STATUS_OBJECT_NAME_NOT_FOUND ObjectAttributes 参数在OBJECT_ATTRIBUTES结构中包含一个找不到的 ObjectName 成员。
STATUS_OBJECT_PATH_NOT_FOUND ObjectAttributes 参数在 OBJECT_ATTRIBUTES 结构中包含一个 ObjectName 成员，该成员具有找不到的对象路径。
STATUS_OBJECT_PATH_SYNTAX_BAD ObjectAttributes 参数不包含 RootDirectory 成员，但 OBJECT_ATTRIBUTES 结构中的 ObjectName 成员是空字符串或不包含OBJECT_NAME_PATH_SEPARATOR字符。 这表示对象路径的语法不正确。

注解

ZwDeleteFile 删除指定的文件对象。

在 InitializeAttributes 宏用于设置要删除的文件对象的OBJECT_ATTRIBUTES结构中的属性之后，将调用 ZwDeleteFile 函数。

可通过两种替代方法指定要使用 ZwDeleteFile 删除的文件的名称：

  • 作为完全限定的路径名，在输入 ObjectAttributes 的 ObjectName 成员中提供
  • 作为相对于输入 ObjectAttributes 的 RootDirectory 成员中的句柄所表示的目录文件的路径名

ZwDeleteFile 的调用方必须在 IRQL = PASSIVE_LEVEL 且启用了特殊内核 APC 的情况下运行。

如果对 ZwDeleteFile 函数的调用在用户模式下发生，则应使用名称“NtDeleteFile ”而不是“ZwDeleteFile”。

对于来自内核模式驱动程序的调用，Windows Native System Services 例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。

要求

要求 值
最低受支持的客户端 Windows XP
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL (请参阅“备注”部分)
DDI 符合性规则 HwStorPortProhibitedDDI (storport) ， PowerIrpDDis (wdm)

另请参阅

InitializeObjectAttributes

OBJECT_ATTRIBUTES