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 |