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”部分。