IoQueryFileDosDeviceName, fonction (ntifs.h)
La routine IoQueryFileDosDeviceName récupère un nom d’appareil MS-DOS pour un fichier.
Syntaxe
NTSTATUS IoQueryFileDosDeviceName(
[in] PFILE_OBJECT FileObject,
[out] POBJECT_NAME_INFORMATION *ObjectNameInformation
);
Paramètres
[in] FileObject
Pointeur vers un objet de fichier pour le fichier.
[out] ObjectNameInformation
Pointeur retourné vers une structure de OBJECT_NAME_INFORMATION nouvellement allouée. Cette structure est renseignée lors d’un retour réussi avec les informations de nom de l’appareil MS-DOS. La structure est définie comme suit :
typedef struct _OBJECT_NAME_INFORMATION {
UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;
Remarque Cette structure doit éventuellement être libérée en appelant ExFreePool.
Valeur de retour
IoQueryFileDosDeviceName retourne STATUS_SUCCESS ou une valeur NTSTATUS d’erreur, telle que STATUS_INSUFFICIENT_RESOURCES.
Remarques
Pour plus d’informations sur les noms MS-DOS, consultez la section Fichiers et E/S de la documentation du Kit de développement logiciel (SDK) platform.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Cette routine est disponible à partir deWindows XP. |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h, Fltkernel.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |