GetFileTime, fonction (fileapi.h)

Article
08/23/2023

Permet d’obtenir la date et l’heure de la création, du dernier accès et de la dernière modification d’un fichier ou d’un répertoire.

Syntaxe

BOOL GetFileTime(
  [in]            HANDLE     hFile,
  [out, optional] LPFILETIME lpCreationTime,
  [out, optional] LPFILETIME lpLastAccessTime,
  [out, optional] LPFILETIME lpLastWriteTime
);

Paramètres

[in] hFile

Handle du fichier ou du répertoire pour lequel les dates et heures doivent être récupérées. Le handle doit avoir été créé à l’aide de la fonction CreateFile avec le droit d’accès GENERIC_READ . Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.

[out, optional] lpCreationTime

Pointeur vers une structure FILETIME pour recevoir la date et l’heure de création du fichier ou du répertoire. Ce paramètre peut avoir la valeur NULL si l’application n’a pas besoin de ces informations.

[out, optional] lpLastAccessTime

Pointeur vers une structure FILETIME pour recevoir la date et l’heure du dernier accès au fichier ou au répertoire. Le dernier délai d’accès inclut la dernière fois où le fichier ou le répertoire a été écrit, lu ou, dans le cas des fichiers exécutables, exécuté. Ce paramètre peut avoir la valeur NULL si l’application n’a pas besoin de ces informations.

[out, optional] lpLastWriteTime

Pointeur vers une structure FILETIME pour recevoir la date et l’heure de la dernière écriture du fichier ou du répertoire, tronqué ou remplacé (par exemple, avec WriteFile ou SetEndOfFile). Cette date et heure n’est pas mise à jour lorsque les attributs de fichier ou les descripteurs de sécurité sont modifiés. Ce paramètre peut avoir la valeur NULL si l’application n’a pas besoin de ces informations.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Tous les systèmes de fichiers ne peuvent pas enregistrer les heures de création et de dernier accès, et tous les systèmes de fichiers ne les enregistrent pas de la même manière. Par exemple, sur 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). 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 .

NTFS retarde les mises à jour jusqu’à l’heure du dernier accès d’un fichier jusqu’à une heure après le dernier accès. NTFS permet également de désactiver les mises à jour de l’heure du dernier accès. L’heure du dernier accès n’est pas mise à jour sur les volumes NTFS par défaut.

Windows Server 2003 et Windows XP : L’heure du dernier accès est mise à jour sur les volumes NTFS par défaut.

Pour plus d’informations, consultez Heures de fichiers.

Si vous renommez ou supprimez un fichier, puis restaurez-le peu après, Windows recherche dans le cache des informations de fichier à restaurer. Les informations mises en cache incluent la paire de noms court/long et le temps de création.

Exemples

Pour obtenir un exemple, consultez Récupération de l’heure Last-Write.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	fileapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll