structure FILE_BASIC_INFORMATION (wdm.h)

Article
02/07/2025

La structure FILE_BASIC_INFORMATION contient des horodatages et des attributs de base d’un fichier. Il est utilisé comme argument pour les routines qui interrogent ou définissent des informations de fichier.

Syntaxe

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

Membres

CreationTime

Spécifie l’heure à laquelle le fichier a été créé.

LastAccessTime

Spécifie l’heure à laquelle le fichier a été consulté pour la dernière fois.

LastWriteTime

Spécifie l’heure à laquelle le fichier a été écrit pour la dernière fois.

ChangeTime

Spécifie la dernière fois que le fichier a été modifié.

FileAttributes

Spécifie un ou plusieurs indicateurs deXXX FILE_ATTRIBUTE_. Pour obtenir des descriptions de ces indicateurs, consultez constantes d’attributs de fichier dans le Kit de développement logiciel (SDK) Microsoft Windows.

Remarques

L’indicateur FILE_ATTRIBUTE_NORMAL ne peut pas être défini ou retourné en combinaison avec d’autres attributs. Toutes les autres FileAttributes valeurs remplacent cet attribut.

Les valeurs d’heure CreationTime, LastAccessTime, LastWriteTimeet ChangeTime sont exprimées 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 dans le calendrier grégorien.

Si vous spécifiez la valeur zéro pour l’une des XxxTime membres de la structure FILE_BASIC_INFORMATION, la fonction ZwSetInformationFile conserve le paramètre actuel d’un fichier pour cette heure.

Le système de fichiers met à jour les valeurs des LastAccessTime, LastWriteTimeet membres changeTime selon les besoins après l’exécution d’une opération d’E/S sur un fichier. Un pilote ou une application peut demander que le système de fichiers ne met pas à jour un ou plusieurs de ces membres pour les opérations d’E/S effectuées sur le handle de fichier de l’appelant en définissant les membres appropriés sur -1. L’appelant peut définir un, tous ou toute autre combinaison de ces trois membres sur -1. Seuls les membres définis sur -1 ne seront pas affectés par les opérations d’E/S sur le handle de fichier ; les autres membres seront mis à jour selon les besoins. Sur les systèmes NTFS et ReFS, les mises à jour d’horodatage sur le handle de fichier peuvent être restaurées en définissant le ou les membres appropriés sur -2.

Pour définir les membres de cette structure, l’appelant doit avoir FILE_WRITE_ATTRIBUTES accès au fichier.