_futime, _futime32, _futime64

Articolo
03/05/2013

Imposta l'ora di modifica a un file aperto.

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

Parametri

fd
Descrittore del file al file aperto.
filetime
Puntatore a una struttura contenente la nuova data della modifica.

Valore restituito

Restituiscono 0 se ha esito positivo.Se si verifica un errore, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, la funzione restituisce a 1 e errno è impostato su EBADF, che indica un descrittore di file non valido, o EINVAL, che indica un parametro non valido.

Note

_futime la routine imposta la data di modifica e l'ora di accesso a un file aperto associato fd. _futime equivale a _utime, ad eccezione del fatto che il relativo argomento è il descrittore di un file aperto, anziché il nome di un file o un percorso di un file._utimbuf la struttura contiene i campi per il nuovo data/ora e di accesso di modifica.Entrambi i campi devono contenere valori validi._utimbuf32 e _utimbuf64 essere identico a _utimbuf fatta eccezione per l'utilizzo di 32 bit e i tipi di tempo a 64 bit, rispettivamente._futime e _utimbuf utilizzare un tipo di tempo a 64 bit e _futime è identico nel comportamento a _futime64.Se è necessario definire il comportamento precedente, definire _USE_32BIT_TIME_T.Utilizzando l'istanza _futime per essere identico nel comportamento a _futime32 portando l'orario _utimbuf struttura per utilizzare il tipo di tempo a 32 bit, rendendo la equivalente a __utimbuf32.

_futime64, che utilizza __utimbuf64 la struttura, può leggere e modificare le date del file con il 23:59: 59, il 31 dicembre, 3000, UTC, mentre una chiamata a _futime32 ha esito negativo se la data nel file è successiva a le 19:14: 7 gennaio 18, 2038, UTC.La mezzanotte, il 1° gennaio 1970, è il limite inferiore dell'intervallo di date per queste funzioni.

Requisiti

Funzione	Intestazione di associazione	intestazione facoltativa
_futime	<sistema/utime.h>	<errno.h>
_futime32	<sistema/utime.h>	<errno.h>
_futime64	<sistema/utime.h>	<errno.h>

Per ulteriori informazioni sulla compatibilità, vedere compatibilità nell'introduzione.

Esempio

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

input: crt_futime.c_input

Arbitrary file contents.

Esempio di output

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

Vedere anche

Riferimenti

Gestione di tempo

Condividi tramite