_futime, _futime32, _futime64

2015-06-09

Legt die Änderungszeit auf einer geöffneten Datei fest.

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

Parameter

fd
Dateideskriptor der geöffneten Datei.
filetime
Zeiger zur Struktur, die das neue Änderungsdatum enthält.

Rückgabewert

EINGABETASTE, wenn 0 erfolgreich. Wenn ein Fehler auftritt, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die Ausführung zulässig ist, um fortzufahren, kehrt die Funktion zurück - 1 und errno ist auf EBADF festgelegt und gibt ein ungültiges Dateideskriptor oder EINVAL an und gibt ein ungültiges Parameter an.

Hinweise

Die Routine _futime legt das Änderungsdatum und die Zugriffsgeschwindigkeit auf der geöffneten Datei fest, die fd zugeordnet ist . _futime wird _utime identisch, nur dass Argument ist der Dateideskriptor einer geöffneten Datei, und der Name einer Datei oder eines Pfads zu einer Datei. Die _utimbuf-Struktur enthält Felder während des neuen Änderungsdatums und -Zugriffsgeschwindigkeit. Beide Felder müssen gültige Werte enthalten. _utimbuf32 und _utimbuf64 sind in _utimbuf außer dem Verwendung des 32-Bit identisch und 64-Bit-Zeit gibt, bzw. ein. _futime und _utimbuf verwenden einen 64-Bit-Zeittyp und _futime ist im Verhalten mit _futime64 identisch. Wenn Sie das alte Verhalten erzwingen muss, definieren Sie _USE_32BIT_TIME_T. Hierdurch wird _futime32_futime, im Verhalten identisch sein und bewirkt die Struktur _utimbuf, den 32-Bit-Zeittyp verwendet und macht sie äquivalent zu __utimbuf32.

_futime64, die die Struktur __utimbuf64 verwendet, kann Dateidatumsangaben 23:59 lesen und ändern: 59 3000 am 31. Dezember, UTC; während ein Aufruf von _futime32 fehlschlägt, ob das Datum auf der Datei später von 19:14 ist: Am 7. Januar 18 2038, UTC. Mitternacht am 1. Januar 1970 ist die untere Begrenzung des Zeitraums für diese Funktionen.

Anforderungen

Funktion	Erforderlicher Header	Optionaler Header
_futime	<sys/utime.h>	<errno.h>
_futime32	<sys/utime.h>	<errno.h>
_futime64	<sys/utime.h>	<errno.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Beispiel

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

Eingabe: crt_futime.c_input

Arbitrary file contents.

Beispielausgabe

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

.NET Framework-Entsprechung

Siehe auch

Referenz

Uhrzeitverwaltung

Freigeben über