Fonction IoQueryFileDosDeviceName (ntifs.h)

Article
02/26/2024

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 en cas de retour réussi avec les informations de nom d’appareil MS-DOS. La structure est définie comme suit :

typedef struct _OBJECT_NAME_INFORMATION {
    UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;

Note Cette structure doit finalement être libérée en appelant ExFreePool.

Valeur retournée

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) de plateforme.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette routine est disponible à partir deWindows XP.
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h, Fltkernel.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Voir aussi

UNICODE_STRING

Partager via