ObCloseHandle 函数 (wdm.h)
ObCloseHandle 例程关闭对象句柄。
NTSTATUS ObCloseHandle(
[in] HANDLE Handle,
[in] KPROCESSOR_MODE PreviousMode
);
[in] Handle
系统提供的任何类型的对象的句柄。
[in] PreviousMode
指定打开句柄的线程的上一个处理器模式。 若要关闭内核句柄,请将此参数设置为 KernelMode。 若要关闭 用户句柄,请将此参数设置为 UserMode。 有关这两种句柄类型的详细信息,请参阅备注。
如果调用成功,ObCloseHandle 将返回STATUS_SUCCESS。 可能的错误返回值包括以下 NTSTATUS 代码。
返回代码 | 说明 |
---|---|
STATUS_INVALID_HANDLE | 句柄 不是有效的句柄。 |
STATUS_HANDLE_NOT_CLOSABLE | 调用线程没有关闭句柄的权限。 |
内核模式驱动程序调用 ObCloseHandle 以关闭由 Windows 内核创建的任何类型的对象的句柄。 驱动程序必须在不再需要句柄后立即关闭它打开的每个句柄。
在 ObCloseHandle 关闭对象的句柄后,调用方必须将句柄视为无效,并避免使用该句柄访问对象。 但是,同一对象上的其他句柄可能保持打开状态。 在 ObCloseHandle 调用期间,系统会递减对象的句柄计数,并检查是否可以删除该对象。 在关闭对象的所有句柄并释放对象的所有引用计数指针之前,系统不会删除对象。
PreviousMode 参数指定要关闭的句柄是内核句柄还是用户句柄。 若要关闭内核句柄,请将 PreviousMode 设置为 KernelMode。 若要关闭用户句柄,请将 PreviousMode 设置为 UserMode。
内核句柄是由系统线程或内核模式驱动程序打开的句柄,该驱动程序将 OBJ_KERNEL_HANDLE 属性分配给句柄。 (例如,请参阅 ZwCreateFile 中OBJ_KERNEL_HANDLE的说明。) 如果内核模式驱动程序打开句柄供其专用,并且此驱动程序在用户模式线程的上下文中运行,则驱动程序必须使用 OBJ_KERNEL_HANDLE 属性打开句柄。 此属性可确保用户模式应用程序无法访问句柄。
用户句柄是由用户模式应用程序或内核模式驱动程序打开的句柄,该驱动程序在用户模式线程的上下文中运行,但不使用 OBJ_KERNEL_HANDLE 属性打开句柄。 如果驱动程序创建供用户模式应用程序使用的用户句柄,但发生错误,要求驱动程序代表应用程序关闭句柄,则驱动程序可以调用 ObCloseHandle 来关闭句柄。
ZwClose 例程类似于 ObCloseHandle,但只能关闭内核句柄。 调用 ZwClose (hObject) 关闭内核句柄 hObject,其效果与调用 ObCloseHandle (hObject、 KernelMode) 相同。 有关关闭内核句柄的详细信息,请参阅 ZwClose。
若要确定句柄是内核句柄还是用户句柄,接收句柄的驱动程序可以调用 ExGetPreviousMode 例程。 或者,驱动程序可以从描述 I/O 请求的 IRP 结构中读取 RequestorMode 字段。 I/O 管理器将 RequestorMode 字段设置为请求 I/O 操作的线程的上一个处理器模式。
ObCloseHandle 的调用方不应假定此例程在返回之前自动等待所有挂起的 I/O 操作完成。
有关详细信息,请参阅 对象句柄。
在 Windows 7 之前的头文件中未声明 ObCloseHandle。 若要在驱动程序中使用此例程,请在驱动程序代码中包含以下函数声明:
#if (NTDDI_VERSION < NTDDI_WIN7)
NTKERNELAPI
NTSTATUS
ObCloseHandle(
__in HANDLE Handle,
__in KPROCESSOR_MODE PreviousMode
);
#endif
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | wdm.h |
Library | Ntoskrnl.lib |
DLL | Ntoskrnl.exe |
IRQL | PASSIVE_LEVEL |