IoQueryFileDosDeviceName 函数 (ntifs.h)

  • 项目

IoQueryFileDosDeviceName 例程检索文件的 MS-DOS 设备名称。

语法

NTSTATUS IoQueryFileDosDeviceName(
  [in]  PFILE_OBJECT             FileObject,
  [out] POBJECT_NAME_INFORMATION *ObjectNameInformation
);

参数

[in] FileObject

指向文件的文件对象的指针。

[out] ObjectNameInformation

指向新分配 的OBJECT_NAME_INFORMATION 结构的返回指针。 此结构在成功返回时填充 MS-DOS 设备名称信息。 结构定义如下：

typedef struct _OBJECT_NAME_INFORMATION {
    UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;
注意 最终必须通过调用 ExFreePool 释放此结构。
 

返回值

IoQueryFileDosDeviceName 返回STATUS_SUCCESS或错误的 NTSTATUS 值，例如STATUS_INSUFFICIENT_RESOURCES。

注解

有关 MS-DOS 名称的详细信息，请参阅平台软件开发工具包 (SDK) 文档的文件和 I/O 部分。

要求

要求 值
最低受支持的客户端 此例程从 Windows XP 开始可用。
目标平台 通用
标头 ntifs.h (包括 Ntifs.h、Fltkernel.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另请参阅

UNICODE_STRING