NtOpenFile 函数 (ntifs.h)

  • 项目

NtOpenFile 例程打开现有文件、目录、设备或卷。

语法

__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenFile(
  [out] PHANDLE            FileHandle,
  [in]  ACCESS_MASK        DesiredAccess,
  [in]  POBJECT_ATTRIBUTES ObjectAttributes,
  [out] PIO_STATUS_BLOCK   IoStatusBlock,
  [in]  ULONG              ShareAccess,
  [in]  ULONG              OpenOptions
);

参数

[out] FileHandle

指向接收文件句柄的 HANDLE 变量的指针。

[in] DesiredAccess

指定一个 ACCESS_MASK 值，该值确定对 对象的请求访问权限。 有关详细信息，请参阅 NtCreateFile 的 DesiredAccess 参数。

[in] ObjectAttributes

指向 OBJECT_ATTRIBUTES 结构的指针，该结构指定对象名称和其他属性。 使用 InitializeObjectAttributes 初始化此结构。 如果调用方未在系统线程上下文中运行，则必须在调用 InitializeObjectAttributes 时设置 OBJ_KERNEL_HANDLE 属性。

[out] IoStatusBlock

指向 IO_STATUS_BLOCK 结构的指针，该结构接收最终完成状态和有关所请求操作的信息。

[in] ShareAccess

指定文件的共享访问类型。 有关详细信息，请参阅 NtCreateFile 的 ShareAccess 参数。

[in] OpenOptions

指定打开文件时要应用的选项。 有关详细信息，请参阅 NtCreateFile 的 CreateOptions 参数。

返回值

NtOpenFile 返回STATUS_SUCCESS或相应的 NTSTATUS 错误代码。 在后一种情况下，调用方可以通过检查 IoStatusBlock 参数来查找有关失败原因的详细信息。

注解

NtOpenFile 提供一个句柄，调用方可以使用该句柄来操作文件的数据或文件对象的状态和属性。 NtOpenFile 提供 NtCreateFile 提供的功能的子集。 有关详细信息，请参阅 在驱动程序中使用文件。

不再使用 FileHandle 指向的句柄后，驱动程序必须调用 NtClose 以将其关闭。

如果调用方未在系统线程上下文中运行，则必须确保它创建的任何句柄都是专用句柄。 否则，运行驱动程序的上下文中的进程可以访问句柄。 有关详细信息，请参阅 对象句柄。

NtOpenFile 的调用方必须在 IRQL = PASSIVE_LEVEL下运行，并且启用了特殊内核 APC。

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

对于来自内核模式驱动程序的调用，Windows Native System Services 例程的 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、PowerIrpDDis

另请参阅

ACCESS_MASK

InitializeObjectAttributes

NtClose

NtCreateFile