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 值，该值确定请求对对象的访问。 有关详细信息，请参阅 NtCreateFileDesiredAccess 参数。
[in] ObjectAttributes
指向指定对象名称和其他属性的 OBJECT_ATTRIBUTES 结构的指针。 使用 InitializeObjectAttributes 初始化此结构。 如果调用方未在系统线程上下文中运行，则必须在调用 InitializeObjectAttributes时设置OBJ_KERNEL_HANDLE属性。
[out] IoStatusBlock
指向接收最终完成状态和所请求作信息的 IO_STATUS_BLOCK 结构的指针。
[in] ShareAccess
指定文件的共享访问类型。 有关详细信息，请参阅 NtCreateFile的 ShareAccess 参数。
[in] OpenOptions
指定打开文件时要应用的选项。 有关详细信息，请参阅 NtCreateFileCreateOptions 参数。
返回值
NtOpenFile 返回STATUS_SUCCESS或相应的 NTSTATUS 错误代码。 在后一种情况下，调用方可以通过检查 IoStatusBlock 参数来查找有关失败原因的详细信息。
言论
NtOpenFile 提供调用方可用于作文件数据或文件对象的状态和属性的句柄。 NtOpenFile 提供了 NtCreateFile提供的功能子集。 有关详细信息，请参阅 在驱动程序中使用文件。
FileHandle 指向的句柄不再使用后，驱动程序必须调用 NtClose 将其关闭。
如果调用方未在系统线程上下文中运行，则必须确保创建的任何句柄都是专用句柄。 否则，该句柄可由运行驱动程序的上下文的进程访问。 有关详细信息，请参阅 对象句柄。
NtOpenFile 的调用方必须在 IRQL = PASSIVE_LEVEL，启用了特殊内核 APC。
如果在用户模式下调用此函数，则应使用名称“NtOpenFile”而不是“ZwOpenFile”。
对于内核模式驱动程序的调用，NtXxx 和 ZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxx 与 ZwXxx 例程之间的关系的详细信息，请参阅 使用 Nt 和 Zw 版本的本机系统服务例程。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 |
| 目标平台 | 普遍 |
| 标头 | ntifs.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 库 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL（请参阅“备注”部分） |
| DDI 符合性规则 | HwStorPortProhibitedDDI、PowerIrpDDis |