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 cuando se devuelve correctamente con la información del 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 con el tiempo llamando a ExFreePool.
Valor devuelto
IoQueryFileDosDeviceName devuelve STATUS_SUCCESS o un valor NTSTATUS de error, como STATUS_INSUFFICIENT_RESOURCES.
Comentarios
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 (SDK) de plataforma.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Esta rutina está disponible a partir deWindows XP. |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h, Fltkernel.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |