_futime, _futime32, _futime64

Establece el tiempo de modificación en un archivo abierto.

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

Parámetros

• fd
  Descriptor de archivo al archivo abierto.

• filetime
  Puntero a la estructura que contiene la nueva fecha de modificación.

Valor devuelto

Return 0 si correctamente.Si se produce un error, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, la función devuelve – 1 y errno se establece en EBADF, indicando descriptor de archivo no válido, o a EINVAL, que indica un parámetro no válido.

Comentarios

La rutina de _futime establece la fecha de modificación y tiempo de acceso en el archivo abierto asociado a fd*.* _futime es idéntico a _utime, excepto en que el argumento es descriptor de archivo de un archivo abierto, en lugar del nombre de un archivo o una ruta de acceso a un archivo.La estructura de _utimbuf contiene los campos por la nueva fecha y hora de acceso de modificación.ambos campos deben contener valores válidos._utimbuf32 y _utimbuf64 son idénticos a _utimbuf a excepción de los tipos de 32 bits y 64 bits del tiempo, respectivamente._futime y _utimbuf utilizan un tipo de 64 bits del tiempo y _futime es idéntico en comportamiento a _futime64.Si necesita forzar el comportamiento antiguo, defina _USE_32BIT_TIME_T.Ello hace _futime para ser idéntico en comportamiento a _futime32 y hace que la estructura de _utimbuf para utilizar el tipo de 32 bits del tiempo, lo que equivale a __utimbuf32.

_futime64, que utiliza la estructura de __utimbuf64 , puede leer y modificar las fechas del archivo con 23:59: 59, el 31 de diciembre, 3000, hora UTC; mientras que falla una llamada a _futime32 si la fecha del archivo es posterior que 19:14: 7 de enero de 18, 2038, La hora UTC.La medianoche, el 1 de enero de 1970, es el límite inferior del intervalo de fechas para estas funciones.

Requisitos

Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

// 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" );
}

entrada: crt_futime.c_input

Arbitrary file contents.

Resultados del ejemplo

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

Equivalente en .NET Framework

• System:: IO:: archivo:: SetLastAccessTime

• System:: IO:: archivo:: SetLastWriteTime

• System:: IO:: archivo:: SetCreationTime

Vea también

Referencia

Administración de tiempo