Compartir a través de


Función IoQueryFileDosDeviceName (ntifs.h)

La rutina IoQueryFileDosDeviceName recupera un nombre de dispositivo MS-DOS para un archivo.

Sintaxis

NTSTATUS IoQueryFileDosDeviceName(
  [in]  PFILE_OBJECT             FileObject,
  [out] POBJECT_NAME_INFORMATION *ObjectNameInformation
);

Parámetros

[in] FileObject

Puntero a un objeto de archivo para el archivo.

[out] ObjectNameInformation

Puntero devuelto a una estructura de OBJECT_NAME_INFORMATION recién asignada. Esta estructura se rellena en la devolución correcta con la información de nombre del dispositivo MS-DOS. La estructura se define de la siguiente manera:

typedef struct _OBJECT_NAME_INFORMATION {
    UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;
Nota Esta estructura debe liberarse llamando a ExFreePool.
 

Valor devuelto

ioQueryFileDosDeviceName devuelve STATUS_SUCCESS o un valor NTSTATUS de error, como STATUS_INSUFFICIENT_RESOURCES.

Observaciones

Para obtener más información sobre los nombres de MS-DOS, consulte la sección Archivos y E/S de la documentación del Kit de desarrollo de software de plataforma (SDK).

Requisitos

Requisito Valor
cliente mínimo admitido Esta rutina está disponible a partir deWindows XP.
de la plataforma de destino de Universal
encabezado de ntifs.h (incluya Ntifs.h, Fltkernel.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL PASSIVE_LEVEL

Consulte también

UNICODE_STRING