Функция 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

См. также раздел

UNICODE_STRING