_futime, _futime32, _futime64

Define la hora de modificación de un archivo abierto.

Sintaxis

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 para el archivo abierto.

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

Valor devuelto

Si la operación se realiza correctamente, devuelve 0. Si se produce un error, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, la función devuelve -1 y errno se establece EBADFen , lo que indica un descriptor de archivo no válido o EINVAL, que indica un parámetro no válido.

Comentarios

La _futime rutina establece la fecha de modificación y la hora de acceso en el archivo abierto asociado a fd. _futime es idéntico a _utime, excepto que su argumento es el descriptor de archivo de un archivo abierto, en lugar del nombre de un archivo o una ruta de acceso a un archivo. La estructura _utimbuf contiene campos para la nueva fecha de modificación y hora de acceso. Ambos campos deben contener valores válidos. _utimbuf32 y _utimbuf64 son idénticas a _utimbuf, salvo por el uso de los tipos de tiempo de 32 bits y 64 bits, respectivamente. _futime y _utimbuf usan un tipo de tiempo de 64 bits y _futime tiene un comportamiento idéntico a _futime64. Para forzar el comportamiento anterior, defina _USE_32BIT_TIME_T. Al hacerlo, hace que _futime tenga un comportamiento idéntico a _futime32 y que la estructura _utimbuf use el tipo de tiempo de 32 bits, lo que la hace equivalente a __utimbuf32.

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

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Función	Encabezado necesario	Encabezado opcional
_futime	<sys/utime.h>	<errno.h>
_futime32	<sys/utime.h>	<errno.h>
_futime64	<sys/utime.h>	<errno.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

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.

Salida de 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

Consulte también

Administración de tiempo