FILE_NAMES_INFORMATION structure (ntifs.h)

Structure FILE_NAMES_INFORMATION utilisée pour interroger des informations détaillées sur les noms des fichiers dans un répertoire.

Syntaxe

typedef struct _FILE_NAMES_INFORMATION {
  ULONG NextEntryOffset;
  ULONG FileIndex;
  ULONG FileNameLength;
  WCHAR FileName[1];
} FILE_NAMES_INFORMATION, *PFILE_NAMES_INFORMATION;

Membres

NextEntryOffset

Décalage d’octets pour l’entrée FILE_NAMES_INFORMATION suivante, si plusieurs entrées sont présentes dans une mémoire tampon. Ce membre est égal à zéro si aucune autre entrée ne suit celle-ci.

FileIndex

Décalage d’octets du fichier dans le répertoire parent. Ce membre n’est pas défini pour les systèmes de fichiers, tels que NTFS, dans lesquels la position d’un fichier dans le répertoire parent n’est pas fixe et peut être modifiée à tout moment pour maintenir l’ordre de tri.

FileNameLength

Longueur de la chaîne de nom de fichier.

FileName[1]

Premier caractère de la chaîne de nom de fichier. Ceci est suivi en mémoire par le reste de la chaîne.

Remarques

Ces informations peuvent être interrogées de l’une des manières suivantes :

• Appelez ZwQueryDirectoryFile, en passant FileNamesInformation en tant que valeur de FileInformationClass et en passant une mémoire tampon FILE_NAMES_INFORMATION structurée par l’appelant comme valeur de FileInformation.

• Créez un IRP avec le code de fonction principale IRP_MJ_DIRECTORY_CONTROL et le code de fonction secondaire IRP_MN_QUERY_DIRECTORY.

Aucun droit d’accès spécifique n’est requis pour interroger ces informations.

Cette structure doit être alignée sur une limite LONG (4 octets). Si une mémoire tampon contient au moins deux de ces structures, la valeur NextEntryOffset dans chaque entrée, à l’exception de la dernière, se situe sur une limite de 4 octets.

Configuration requise

Voir aussi

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile