Функция 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 возвращает значение NTSTATUS STATUS_SUCCESS или ошибку, например STATUS_INSUFFICIENT_RESOURCES.
Комментарии
Дополнительные сведения об именах MS-DOS см. в разделе Файлы и операции ввода-вывода документации по пакету средств разработки программного обеспечения платформы (SDK).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Эта подпрограмма доступна начиная с Windows XP. |
| Целевая платформа | Универсальное |
| Верхняя часть | ntifs.h (включая Ntifs.h, Fltkernel.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |