FILE_FULL_DIR_INFO structure (winbase.h)

Contient les informations sur le répertoire d’un fichier. Cette structure est retournée par la fonction GetFileInformationByHandleEx lorsque FileFullDirectoryInfo ou FileFullDirectoryRestartInfo est passé dans le paramètre FileInformationClass .

Syntaxe

typedef struct _FILE_FULL_DIR_INFO {
  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;
  ULONG         EaSize;
  WCHAR         FileName[1];
} FILE_FULL_DIR_INFO, *PFILE_FULL_DIR_INFO;

Membres

NextEntryOffset

Décalage de la structure de FILE_FULL_DIR_INFO suivante retournée. Contient zéro (0) 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

Heure à laquelle le fichier a été consulté pour la dernière fois.

LastWriteTime

Heure à laquelle le fichier a été écrit pour la dernière fois.

ChangeTime

Heure de la dernière modification du fichier.

EndOfFile

Nouvelle position absolue de fin du fichier en tant que décalage d’octets entre le début du fichier et la fin du flux de données par défaut 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

Nombre d’octets alloués au fichier. Cette valeur est généralement un multiple de la taille du secteur ou du cluster de l’appareil physique sous-jacent.

FileAttributes

Attributs de fichier. Ce membre peut être n’importe quelle combinaison valide des attributs suivants :

FILE_ATTRIBUTE_ARCHIVE (0x00000020)

FILE_ATTRIBUTE_COMPRESSED (0x00000800)

FILE_ATTRIBUTE_DIRECTORY (0x00000010)

FILE_ATTRIBUTE_HIDDEN (0x00000002)

FILE_ATTRIBUTE_NORMAL (0x00000080)

FILE_ATTRIBUTE_READONLY (0x00000001)

FILE_ATTRIBUTE_SYSTEM (0x00000004)

FILE_ATTRIBUTE_TEMPORARY (0x00000100)

FileNameLength

Longueur du nom de fichier.

EaSize

Taille des attributs étendus pour le 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

La structure FILE_FULL_DIR_INFO est un sous-ensemble des informations contenues dans la structure FILE_ID_BOTH_DIR_INFO. Si les informations supplémentaires ne sont pas nécessaires, l’opération sera plus rapide car elle provient de l’entrée de répertoire ; FILE_ID_BOTH_DIR_INFO contient des informations provenant de l’entrée de répertoire et de la table MFT (Master File Table).

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 FILE_FULL_DIR_INFO 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.

Pour compiler une application qui utilise cette structure, définissez la macro _WIN32_WINNT comme 0x0600 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Configuration requise

Voir aussi

FILE_INFO_BY_HANDLE_CLASS

Structures de gestion des fichiers

GetFileInformationByHandleEx