_futime, _futime32, _futime64

Artikel
02/26/2013

Legt die Änderung zeit für eine offene 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 mit der geöffneten Datei.
filetime
Zeiger auf die neue Struktur, die das Datum der Änderung enthält.

Rückgabewert

Geben Sie 0, wenn der Vorgang erfolgreich war.Wenn ein Fehler auftritt, wird der Ereignishandler aufgerufen, z. B. ungültige Parameter in Parametervalidierungbeschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, kehrt die Funktion zurückgegeben wird errno und 1 festgelegt EBADFund gibt einen ungültigen Dateideskriptor oder EINVALan und gibt ein ungültiger Parameter angegeben.

Hinweise

Die _futime Routine legt das Datum der Änderung und die Zugriffsgeschwindigkeit für eine offene Datei fest, die fdzugeordnet ist*.* _futime ist mit _utimeidentisch, mit der Ausnahme, dass das zugehörige Argument ist der Dateideskriptor einer Datei öffnen und nicht der Name einer Datei oder des Pfads in eine Datei.Die Struktur enthält _utimbuf während des neuen datums Felder ändern und die Zugriffsgeschwindigkeit.Beide Felder müssen gültige Werte enthalten._utimbuf32 und _utimbuf64 sind mit Ausnahme des _utimbuf Verwendung des 32-Bit- und Uhrzeit 64-Bit-den Typen erzeugt identisch._futime und _utimbuf 64-Bit-Zeit verwenden einen Typ und _futime befindet sich im Verhalten zu _futime64identisch.Wenn Sie das alte Verhalten erzwingen müssen, definieren Sie _USE_32BIT_TIME_T.Auf diese Weise wird _futime32_futime , im Verhalten identisch sein und veranlasst die _utimbuf Struktur, 32-Bit-Zeit den Typ der zu verwendenden und macht sie entsprechend __utimbuf32.

_futime64, die die __utimbuf64 Struktur kann Datei Datumsangaben 23:59 lesen und ändern: 59 3000 am 31. Dezember, UTC. _futime32 während ein Aufruf fehl, wenn das Datum für die Datei später als 19:14: Am 7. Januar 18 2038, UTC.Mitternacht am 1. Januar 1970 ist die Untergrenze des Datumsbereichs 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 finden Sie unter Kompatibilität 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

Zeit-Verwaltung

Freigeben über