structure FILE_BASIC_INFORMATION (wdm.h)

Article
03/01/2024

La structure FILE_BASIC_INFORMATION contient des horodatages et des attributs de base d’un fichier. Il est utilisé comme argument pour effectuer des 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 de création du fichier.

LastAccessTime

Spécifie l’heure du dernier accès au fichier.

LastWriteTime

Spécifie l’heure de la dernière écriture du fichier.

ChangeTime

Spécifie l’heure de la dernière modification du fichier.

FileAttributes

Spécifie un ou plusieurs indicateurs FILE_ATTRIBUTE_XXX . Pour obtenir une description de ces indicateurs, consultez Constantes d’attributs de fichier dans le Microsoft Windows SDK.

Remarques

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

Les valeurs de temps CreationTime, LastAccessTime, LastWriteTime et 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’un des membres xxxtime de la structure FILE_BASIC_INFORMATION , la fonction ZwSetInformationFile conserve le paramètre actuel d’un fichier pendant cette période.

Le système de fichiers met à jour les valeurs des membres LastAccessTime, LastWriteTime et ChangeTime comme il convient après l’exécution d’une opération d’E/S sur un fichier. Un pilote ou une application peut demander au système de fichiers de ne pas mettre à 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 au besoin. 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.