Fonction SetFileTime (fileapi.h)

Article
08/23/2023

Définit la date et l’heure de la création, du dernier accès ou de la dernière modification du fichier ou du répertoire spécifié.

Syntaxe

BOOL SetFileTime(
  [in]           HANDLE         hFile,
  [in, optional] const FILETIME *lpCreationTime,
  [in, optional] const FILETIME *lpLastAccessTime,
  [in, optional] const FILETIME *lpLastWriteTime
);

Paramètres

[in] hFile

Handle du fichier ou du répertoire. Le handle doit avoir été créé à l’aide de la fonction CreateFile avec le droit d’accès FILE_WRITE_ATTRIBUTES . Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.

[in, optional] lpCreationTime

Pointeur vers une structure FILETIME qui contient la date et l’heure de création du fichier ou du répertoire. Si l’application n’a pas besoin de modifier ces informations, définissez ce paramètre sur NULL ou sur un pointeur vers une structure FILETIME dont les membres dwLowDateTime et dwHighDateTime sont définis sur 0.

[in, optional] lpLastAccessTime

Pointeur vers une structure FILETIME qui contient la date et l’heure du dernier accès pour le fichier ou le répertoire. Le dernier temps 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é. Si l’application n’a pas besoin de modifier ces informations, définissez ce paramètre sur NULL ou sur un pointeur vers une structure FILETIME dont les membres dwLowDateTime et dwHighDateTime sont définis sur 0.

Pour empêcher les opérations de fichier à l’aide du handle donné de modifier le dernier temps d’accès, appelez SetFileTime immédiatement après l’ouverture du handle de fichier et transmettez une structure FILETIME dont les membres dwLowDateTime et dwHighDateTime sont définis sur 0xFFFFFFFF.

[in, optional] lpLastWriteTime

Pointeur vers une structure FILETIME qui contient la date et l’heure de la dernière modification du fichier ou du répertoire. Si l’application n’a pas besoin de modifier ces informations, définissez ce paramètre sur NULL ou sur un pointeur vers une structure FILETIME dont les membres dwLowDateTime et dwHighDateTime sont définis sur 0.

Pour empêcher les opérations de fichier à l’aide du handle donné de modifier l’heure de la dernière écriture, appelez SetFileTime immédiatement après l’ouverture du handle de fichier et transmettez une structure FILETIME dont les membres dwLowDateTime et dwHighDateTime sont définis sur 0xFFFFFFFF.

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 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.

Exemples

Pour obtenir un exemple, consultez Modification d’une heure de fichier à l’heure actuelle.

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