_futime, _futime32, _futime64
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