Функция 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 для платформы.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Эта подпрограмма доступна начиная сWindows XP. |
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (include Ntifs.h, Fltkernel.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |