NtQueryInformationFile 函数 （ntifs.h）
NtQueryInformationFile 例程返回有关文件对象的各种信息。 另请参阅 NtQueryInformationByName，它可以更有效地用于几个文件信息类。
语法
__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass
);
参数
[in] FileHandle
文件对象的句柄。 句柄是通过成功调用 NtCreateFile 或 NtOpenFile创建的，或者对等效的文件创建或打开例程创建的。
[out] IoStatusBlock
指向接收最终完成状态和有关作信息的 IO_STATUS_BLOCK 结构的指针。 信息 成员接收此例程实际写入 FileInformation 缓冲区的字节数。
[out] FileInformation
指向调用方分配的缓冲区的指针，该缓冲区例程将请求的信息写入文件对象。 FileInformationClass 参数指定调用方请求的信息类型。
[in] Length
FileInformation指向的缓冲区的大小（以字节为单位）。
[in] FileInformationClass
指定要在 FileInformation 指向的缓冲区中返回有关文件的信息的类型。 设备和中间驱动程序可以指定以下任何 FILE_INFORMATION_CLASS 值（从最低到最高枚举值列出）：
| FILE_INFORMATION_CLASS值 | 返回的信息类型 |
|---|---|
| FileBasicInformation （4） | FILE_BASIC_INFORMATION 结构。 调用方必须已使用 DesiredAccess 参数中指定的FILE_READ_ATTRIBUTES标志打开该文件。 |
| FileStandardInformation （5） | FILE_STANDARD_INFORMATION 结构。 只要文件处于打开状态，调用方就可以查询此信息，而无需 DesiredAccess的任何特定要求。 |
| FileInternalInformation （6） | FILE_INTERNAL_INFORMATION 结构。 此结构指定一个 64 位文件 ID，用于唯一标识 NTFS 中的文件。 在其他文件系统上，不保证此文件 ID 是唯一的。 |
| FileEaInformation （7） | FILE_EA_INFORMATION 结构。 此结构指定与文件关联的扩展属性块的大小。 |
| FileAccessInformation （8） | FILE_ACCESS_INFORMATION 结构。 此结构包含访问掩码。 有关访问掩码的详细信息，请参阅 ACCESS_MASK。 |
| FileNameInformation （9） | FILE_NAME_INFORMATION 结构。 该结构可以包含文件的完整路径，也可以仅包含文件的一部分。 只要文件处于打开状态，调用方就可以查询此信息，而无需 DesiredAccess的任何特定要求。 有关文件名语法的详细信息，请参阅本主题后面的“备注”部分。 |
| FilePositionInformation （14） | FILE_POSITION_INFORMATION 结构。 调用方必须已打开文件，该文件的 DesiredAccess FILE_READ_DATA 或FILE_WRITE_DATA标志在 DesiredAccess 参数中指定的，以及 createOptions 参数中指定的 FILE_SYNCHRONOUS_IO_ALERT或FILE_SYNCHRONOUS_IO_NONALERT标志。 |
| FileModeInformation （16） | FILE_MODE_INFORMATION 结构。 此结构包含一组标志，用于指定可在其中访问文件的模式。 这些标志是在 IoCreateFile 例程的 CreateOptions 参数中指定的选项的子集。 |
| FileAlignmentInformation （17） | FILE_ALIGNMENT_INFORMATION 结构。 只要文件处于打开状态，调用方就可以查询此信息，而无需 DesiredAccess的任何特定要求。 如果使用 createOptions 参数 中指定的FILE_NO_INTERMEDIATE_BUFFERING标志打开文件，则此信息非常有用。 |
| FileAllInformation （18） | FILE_ALL_INFORMATION 结构。 通过将多个文件信息结构合并为单个结构，FILE_ALL_INFORMATION 减少获取有关文件的信息所需的查询数。 |
| FileAlternateNameInformation （21） | FILE_ALL_INFORMATION 结构，用于返回文件的备用名称信息（其 8.3 格式名称）。 |
| FileStreamInformation （22） | 用于枚举文件或目录数据流的 FILE_STREAM_INFORMATION 结构的缓冲区。 |
| FileCompressionInformation （28） | 要在其中返回文件的压缩信息的 FILE_COMPRESSION_INFORMATION 结构。 |
| FileNetworkOpenInformation （34） | FILE_NETWORK_OPEN_INFORMATION 结构。 调用方必须已使用 DesiredAccess 参数中指定的FILE_READ_ATTRIBUTES标志打开该文件。 |
| FileAttributeTagInformation （35） | FILE_ATTRIBUTE_TAG_INFORMATION 结构。 调用方必须已使用 DesiredAccess 参数中指定的FILE_READ_ATTRIBUTES标志打开该文件。 |
| FileIoPriorityHintInformation （43） | FILE_IO_PRIORITY_HINT_INFORMATION 结构。 调用方必须已使用 DesiredAccess 参数中指定的FILE_READ_DATA标志打开该文件。 |
| FileSfioReserveInformation （44） | FILE_SFIO_RESERVE_INFORMATION 结构。 |
| FileHardLinkInformation （46） | FILE_LINKS_INFORMATION 结构。 |
| FileNormalizedNameInformation （48） | 要在其中返回文件的规范化名称的 FILE_NAME_INFORMATION 结构。 |
| FileIsRemoteDeviceInformation （51） | FILE_IS_REMOTE_DEVICE_INFORMATION 结构。 只要文件处于打开状态，调用方就可以查询此信息，而无需 DesiredAccess的任何特定要求。 |
| FileStandardLinkInformation （54） | FILE_STANDARD_LINK_INFORMATION 结构。 |
| FileIdInformation （59） | FILE_ID_INFORMATION 结构。 |
| FileDesiredStorageClassInformation （67） | FILE_DESIRED_STORAGE_CLASS_INFORMATION 结构。 |
| FileStatInformation （68） | FILE_STAT_INFORMATION |
| FileStatLxInformation （70） | FILE_STAT_LX_INFORMATION |
| FileCaseSensitiveInformation （71） | FILE_CASE_SENSITIVE_INFORMATION 结构。 调用方必须已使用 DesiredAccess 参数中指定的FILE_READ_ATTRIBUTES标志打开该文件。 此值从 Windows 10 版本 1803 开始可用。 |
| FileStorageReserveIdInformation （74） | FILE_STORAGE_RESERVE_ID_INFORMATION 结构。 |
| FileCaseSensitiveInformationForceAccessCheck （75） | FILE_CASE_SENSITIVE_INFORMATION 结构。 调用方必须已使用 DesiredAccess 参数中指定的FILE_READ_ATTRIBUTES标志打开该文件。 这是 FileCaseSensitiveInformation作的特殊版本，用于强制 IOManager 对内核模式驱动程序执行访问检查，类似于适用于用户模式调用者的检查。 此作只能由 IOManager 识别，文件系统不应收到它。 此值从 Windows 10 版本 1803 开始可用。 |
| FileKnownFolderInformation （76） | FILE_KNOWN_FOLDER_INFORMATION 结构。 从 Windows Server 2022 开始可用。 |
返回值
NtQueryInformationFile 返回STATUS_SUCCESS或相应的 NTSTATUS 错误代码。
言论
NtQueryInformationFile 返回有关指定文件对象的信息。 请注意，它在特定设备或文件系统不支持的 FILE_XXX_INFORMATION 结构的任何成员中返回零。
FileInformationClass = FileNameInformation时，文件名将在 FILE_NAME_INFORMATION 结构中返回。 文件名的精确语法取决于多种因素：
如果通过将完整路径提交到 NtCreateFile打开文件，NtQueryInformationFile 将返回该完整路径。
如果 ObjectAttributes->RootDirectory 句柄在调用 NtCreateFile中打开，并且随后 NtCreateFile 相对于此根目录句柄打开该文件，NtQueryInformationFile 返回完整路径。
如果在调用 NtCreateFile时，文件 ID（使用FILE_OPEN_BY_FILE_ID标志）打开了 ObjectAttributes->RootDirectory 句柄，则 NtCreateFile 打开该文件，NtQueryInformationFile 返回相对路径。
但是，如果用户 SeChangeNotifyPrivilege（Microsoft Windows SDK 文档中所述），NtQueryInformationFile 在所有情况下返回完整路径。
如果仅返回相对路径，则文件名字符串不会以反斜杠开头。
如果返回完整路径和文件名，字符串将以单个反斜杠开头，而不考虑其位置。 因此，文件 C：\dir1\dir2\filename.ext 将显示为 \dir1\dir2\filename.ext，而文件 \server\share\dir1\dir2\filename.ext 将显示为 \server\share\dir1\dir2\filename.ext。
如果 NtQueryInformationFile 由于缓冲区溢出而失败，则实现 FileNameInformation 的驱动程序应返回与缓冲区中一样多的文件名的 WCHAR 字符，并指定 FILE_NAME_INFORMATION 结构的 FileNameLength 参数中所需的完整长度。 应使用文件名长度重新发出查询，以便检索完整的文件名。 不遵循此模式的驱动程序可能需要在检索完整文件名之前逐渐增加长度。 有关处理文件的详细信息，请参阅 在驱动程序中使用文件。
NtQueryInformationFile 的调用方必须在 IRQL = PASSIVE_LEVEL，并且 启用了特殊内核 APC。
注意
如果在用户模式下调用此函数，则应使用名称“NtQueryInformationFile”而不是“ZwQueryInformationFile”。
对于内核模式驱动程序的调用，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 |
另请参阅
FILE_ATTRIBUTE_TAG_INFORMATION
FILE_IO_PRIORITY_HINT_INFORMATION