Structure FILETIME (minwinbase.h)

Contient une valeur 64 bits représentant le nombre d’intervalles de 100 nanosecondes depuis le 1er janvier 1601 (UTC).

Syntaxe

typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME, *PFILETIME, *LPFILETIME;

Membres

dwLowDateTime

Partie d’ordre inférieur de l’heure du fichier.

dwHighDateTime

Partie d’ordre élevé de l’heure du fichier.

Remarques

Pour convertir une structure FILETIME en heure facile à afficher pour un utilisateur, utilisez la fonction FileTimeToSystemTime .

Il n’est pas recommandé d’ajouter et de soustraire des valeurs de la structure FILETIME pour obtenir des heures relatives. Au lieu de cela, vous devez copier les parties d’ordre faible et élevé du temps de fichier dans une structure de ULARGE_INTEGER , effectuer une arithmétique 64 bits sur le membre QuadPart et copier les membres LowPart et HighPart dans la structure FILETIME .

Ne convertissez pas de pointeur vers une structure FILETIME vers une valeur ULARGE_INTEGER* ou __int64* , car cela peut provoquer des erreurs d’alignement sur Windows 64 bits.

Tous les systèmes de fichiers ne peuvent pas enregistrer la création et l’heure du dernier accès, et tous les systèmes de fichiers ne les enregistrent pas de la même manière. Par exemple, sur NT FAT, le temps de création a une résolution de 10 millisecondes, le temps d’écriture a une résolution de 2 secondes et le temps d’accès a une résolution de 1 jour (en fait, la date d’accès). Sur NTFS, le temps d’accès a une résolution de 1 heure. Par conséquent, la fonction GetFileTime peut ne pas retourner les mêmes informations de temps de fichier définies à l’aide de la fonction SetFileTime . En outre, FAT enregistre les heures sur le disque en heure locale. Toutefois, NTFS enregistre les heures sur le disque en UTC. Pour plus d’informations, consultez Heures de fichiers.

Une fonction utilisant la structure FILETIME peut autoriser des valeurs en dehors de zéro ou de valeurs positives généralement spécifiées par les membres dwLowDateTime et dwHighDateTime . Par exemple, la fonction SetFileTime utilise 0xFFFFFFFF pour spécifier que le temps d’accès précédent d’un fichier doit être conservé. Pour plus d’informations, consultez la rubrique relative à la fonction que vous appelez.

Exemples

Pour obtenir un exemple, consultez Modification d’une heure de fichier à l’heure actuelle ou Récupération de l’heure Last-Write.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
En-tête minwinbase.h (inclure Windows.h)

Voir aussi

CompareFileTime

Heures de fichier

FileTimeToSystemTime

GetFileTime

ULARGE_INTEGER