FILE_DIRECTORY_INFORMATION structure (ntifs.h)
La structure FILE_DIRECTORY_INFORMATION est utilisée pour interroger des informations détaillées sur les fichiers d’un répertoire.
Syntaxe
typedef struct _FILE_DIRECTORY_INFORMATION {
ULONG NextEntryOffset;
ULONG FileIndex;
LARGE_INTEGER CreationTime;
LARGE_INTEGER LastAccessTime;
LARGE_INTEGER LastWriteTime;
LARGE_INTEGER ChangeTime;
LARGE_INTEGER EndOfFile;
LARGE_INTEGER AllocationSize;
ULONG FileAttributes;
ULONG FileNameLength;
WCHAR FileName[1];
} FILE_DIRECTORY_INFORMATION, *PFILE_DIRECTORY_INFORMATION;
Membres
NextEntryOffset
Décalage d’octets de l’entrée FILE_DIRECTORY_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.
CreationTime
Heure de création du fichier.
LastAccessTime
Dernière fois que le fichier a été consulté.
LastWriteTime
Heure de la dernière écriture des informations dans le fichier.
ChangeTime
Dernière fois que le fichier a été modifié.
EndOfFile
Nouvelle position absolue de fin du fichier en tant que décalage d’octets par rapport au début du fichier. EndOfFile spécifie le décalage d’octets à la fin du fichier. Étant donné que cette valeur est de base zéro, elle fait en fait référence au premier octet libre dans le fichier. En d’autres termes, EndOfFile est le décalage vers l’octet qui suit immédiatement le dernier octet valide dans le fichier.
AllocationSize
Taille de l’allocation de fichiers, en octets. En règle générale, cette valeur est un multiple de la taille du secteur ou du cluster de l’appareil physique sous-jacent.
FileAttributes
Attributs de fichier, qui peuvent être n’importe quelle combinaison valide des éléments suivants :
- FILE_ATTRIBUTE_ARCHIVE
- FILE_ATTRIBUTE_COMPRESSED
- FILE_ATTRIBUTE_DIRECTORY
- FILE_ATTRIBUTE_HIDDEN
- FILE_ATTRIBUTE_NORMAL
- FILE_ATTRIBUTE_READONLY
- FILE_ATTRIBUTE_SYSTEM
- FILE_ATTRIBUTE_TEMPORARY
FileNameLength
Spécifie la longueur de la chaîne de nom de fichier.
FileName[1]
Spécifie le 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 transmettant FileDirectoryInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_DIRECTORY_INFORMATION-structurée alloué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.
Toutes les dates et heures sont au format d’heure système absolu. L’heure système absolue est le nombre d’intervalles de 100 nanosecondes depuis le début de l’année 1601.
Cette structure doit être alignée sur une limite LONGLONG (8 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 8 octets.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntifs.h (include Ntifs.h, Fltkernel.h) |