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)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另请参阅

UNICODE_STRING