_futime, _futime32, _futime64

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Définit l’heure de modification sur un fichier ouvert.

int _futime(   
   int fd,  
   struct _utimbuf *filetime   
);  
int _futime32(   
   int fd,  
   struct __utimbuf32 *filetime   
);  
int _futime64(   
   int fd,  
   struct __utimbuf64 *filetime   
);  

Paramètres

fd
Descripteur de fichier pour le fichier ouvert.

filetime
Pointeur vers la structure qui contient la nouvelle date de modification.

Retourne 0 si l’opération réussit. Si une erreur se produit, le Gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l’exécution est autorisée à se poursuivre, la fonction retourne –&1; et errno a EBADF, qui indique un descripteur de fichier non valide, ou EINVAL, qui indique un paramètre non valide.

Le _futime routine définit la date de modification et le temps d’accès sur le fichier ouvert associé fd . _futimeest identique à _utime, à ceci près que son argument est le descripteur de fichier d’un fichier ouvert, plutôt que le nom d’un fichier ou un chemin d’accès à un fichier. Le _utimbuf structure contient des champs pour la nouvelle date de modification et le temps d’accès. Les deux champs doivent contenir des valeurs valides. _utimbuf32et _utimbuf64 sont identiques aux _utimbuf sauf pour l’utilisation des types de temps 32 bits et 64 bits, respectivement. _futimeet _utimbuf utiliser un type au moment de 64 bits et _futime est un comportement identique à _futime64. Si vous avez besoin forcer l’ancien comportement, définissez _USE_32BIT_TIME_T. Cette opération alors _futime à un comportement identique à _futime32 et provoque la _utimbuf structure à utiliser le type au moment de 32 bits, ce qui équivaut à __utimbuf32.

_futime64, qui utilise le __utimbuf64 de la structure, qui peut lire et modifier les dates de fichier à 23:59:59 le 31 décembre 3000 UTC ; tandis qu’un appel à _futime32 échoue si la date du fichier est ultérieure à 23:59:59 18 janvier 2038, UTC. Minuit, le 1er janvier 1970, est la limite inférieure de la plage de dates pour ces fonctions.

FonctionEn-tête requisEn-tête facultatif
_futime<errno.h>
_futime32<errno.h>
_futime64<errno.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility dans l’introduction.

// crt_futime.c  
// This program uses _futime to set the  
// file-modification time to the current time.  
  
#include <stdio.h>  
#include <stdlib.h>  
#include <fcntl.h>  
#include <io.h>  
#include <sys/types.h>  
#include <sys/stat.h>  
#include <sys/utime.h>  
#include <share.h>  
  
int main( void )  
{  
   int hFile;  
  
   // Show file time before and after.   
   system( "dir crt_futime.c_input" );  
  
   _sopen_s( &hFile, "crt_futime.c_input", _O_RDWR, _SH_DENYNO, 0 );  
  
   if( _futime( hFile, NULL ) == -1 )  
      perror( "_futime failed\n" );  
   else  
      printf( "File time modified\n" );  
  
   _close (hFile);  
  
   system( "dir crt_futime.c_input" );  
}  

Arbitrary file contents.  

Résultat de l'exemple

Volume in drive Z has no label.  
 Volume Serial Number is 5C68-57C1  
  
 Directory of Z:\crt  
  
03/25/2004  10:40 AM                24 crt_futime.c_input  
               1 File(s)             24 bytes  
               0 Dir(s)  24,268,476,416 bytes free  
 Volume in drive Z has no label.  
 Volume Serial Number is 5C68-57C1  
  
 Directory of Z:\crt  
  
03/25/2004  10:41 AM                24 crt_futime.c_input  
               1 File(s)             24 bytes  
               0 Dir(s)  24,268,476,416 bytes free  
File time modified  

Gestion du temps

Afficher: