NtClose 函数 (ntifs.h)

NtClose 例程关闭对象句柄。

语法

__kernel_entry NTSYSCALLAPI NTSTATUS NtClose(
  [in] HANDLE Handle
);

参数

[in] Handle

任何类型的对象的句柄。

返回值

NtClose 在成功时返回STATUS_SUCCESS，或者返回相应的 NTSTATUS 错误代码，如下所示。

返回代码	含义
STATUS_INVALID_HANDLE	句柄 不是有效的句柄。
STATUS_HANDLE_NOT_CLOSABLE	调用线程没有关闭句柄的权限;也就是说，指定的对象句柄受到保护，防止 NtClose 的任何实例尝试关闭。

发生后一个 NTSTATUS 代码的示例是，调用 ZwDuplicateObject 时， OBJ_PROTECT_CLOSE 传递给 handle attributes 参数参数。 内核确保在这种情况下不能关闭句柄。

注解

NtClose 是一个泛型例程，可对任何类型的对象进行操作。

关闭打开的对象句柄会导致该句柄无效。 系统还会递减对象的句柄计数，并检查是否可以删除该对象。 在关闭对象的所有句柄并且未保留引用的指针之前，系统不会实际删除对象。

驱动程序必须在不再需要句柄后立即关闭它打开的每个句柄。 仅当以前的处理器模式为 KernelMode 时，才能关闭由系统线程或指定OBJ_KERNEL_HANDLE标志打开的内核句柄。 此要求既适用于系统线程，也适用于从内核模式颁发的 IRP 调度例程。 (有关以前的处理器模式的详细信息，请参阅 ExGetPreviousMode.) 例如， NtCreateKey 返回到 DriverEntry 例程的句柄随后无法由同一驱动程序的 调度例程关闭。 DriverEntry 例程在系统进程中运行，而调度例程通常在发出当前 I/O 请求的线程上下文中运行，或者对于较低级别的驱动程序，在任意线程上下文中运行。

仅当满足以下两个条件之一时，才能关闭非内核句柄：以前的处理器模式为 KernelMode，或者调用线程具有关闭句柄的足够权限。 当调用线程是创建句柄的线程时，将发生后者的示例。

NtClose 的调用方不应假定此例程在返回之前自动等待所有 I/O 完成。

如果在用户模式下调用此函数，则应使用名称“NtClose”而不是“ZwClose”。

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

要求

要求	值
最低受支持的客户端	Windows 2000
目标平台	通用
标头	ntifs.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI、IrqlZwPassive、PowerIrpDDis、ZwRegistryCreate、ZwRegistryCreate (storport) 、ZwRegistryOpen、ZwRegistryOpen (storport)

另请参阅

ZwCreateDirectoryObject

ZwCreateFile

ZwCreateKey

ZwOpenKey

ZwOpenSection