GetFileTime, fonction (fileapi.h)
Récupère la date et l’heure de création d’un fichier ou d’un répertoire, du dernier accès et de la dernière modification.
Syntaxe
BOOL GetFileTime(
[in] HANDLE hFile,
[out, optional] LPFILETIME lpCreationTime,
[out, optional] LPFILETIME lpLastAccessTime,
[out, optional] LPFILETIME lpLastWriteTime
);
Paramètres
[in] hFile
Handle vers le fichier ou le 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 être NULL si l’application ne nécessite pas ces informations.
[out, optional] lpLastAccessTime
Pointeur vers une structure FILETIME pour recevoir la date et l’heure auxquelles le fichier ou le répertoire a été accédé pour la dernière fois. La dernière heure d’accès inclut l’heure à laquelle le fichier ou le répertoire a été écrit, lu ou, dans le cas des fichiers exécutables, exécutés. Ce paramètre peut être NULL si l’application ne nécessite pas ces informations.
[out, optional] lpLastWriteTime
Pointeur vers une structure FILETIME pour recevoir la date et l’heure auxquelles le fichier ou le répertoire a été écrit pour la dernière fois dans, tronqué ou remplacé (par exemple, avec WriteFile ou SetEndOfFile). Cette date et cette heure ne sont pas mises à jour lorsque les attributs de fichier ou les descripteurs de sécurité sont modifiés. Ce paramètre peut être NULL si l’application ne nécessite pas 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 pas tous les systèmes de fichiers les enregistrer de la même manière. Par exemple, sur FAT, l’heure de création a une résolution de 10 millisecondes, l’heure d’écriture a une résolution de 2 secondes et l’heure d’accès a une résolution de 1 jour (vraiment, 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 de la dernière heure d’accès d’un fichier jusqu’à une heure après le dernier accès. NTFS autorise également la désactivation des dernières mises à jour de l’heure d’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 fichier.
Si vous renommez ou supprimez un fichier, puis restaurez-le peu après, Windows recherche dans le cache les informations de fichier à restaurer. Les informations mises en cache incluent sa paire de noms courte/longue et son heure de création.
Exemples
Pour obtenir un exemple, consultez Récupération de l’heure Last-Write.
Configuration requise
| 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 (include Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |