structure FILE_NAMES_INFORMATION (ntifs.h)

Structure FILE_NAMES_INFORMATION utilisée pour interroger des informations détaillées sur les noms de fichiers d’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’octet pour l’entrée de 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’octet 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 comme valeur de FileInformationClass et en passant une mémoire tampon FILE_NAMES_INFORMATION-structurée allouée par l’appelant comme valeur de FileInformation.

• Créez un IRP avec le code de fonction principal 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 deux ou plusieurs de ces structures, la NextEntryOffset valeur dans chaque entrée, sauf la dernière, se trouve sur une limite de 4 octets.

Exigences

Voir aussi

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile