_futime, _futime32, _futime64

Článek
06/09/2015

Otevřít soubor nastaví čas změny.

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

Parametry

fd
Popisovač souboru k otevření souboru.
filetime
Ukazatel na strukturu obsahující nové datum změny.

Vrácená hodnota

V případě úspěchu vrátí 0.Pokud dojde k chybě je vyvoláno neplatný parametr popisovače, jak je popsáno v Ověření parametru.Pokud je povoleno spuštění pokračovat, vrátí funkce hodnotu –1 a errno je nastavena na EBADF, určující popisovač souboru je neplatná nebo EINVAL, označující neplatný parametr.

Poznámky

_futime Rutina nastaví datum změny a čas přístupu přidružený k otevření souboru fd*.*_futime je shodné s _utime, až na to, že jeho argument je popisovač souboru otevřeného souboru, nikoli název souboru nebo cestu k souboru. _utimbuf Struktury obsahuje pole pro nové změny datum a čas přístupu.Obě pole musí obsahovat platné hodnoty._utimbuf32a _utimbuf64 jsou shodné s _utimbuf s výjimkou použití typů 32bitové a 64bitové čas resp.._futimea _utimbuf typ 64 bit čas a _futime je shodné v chování _futime64.Pokud potřebujete v platnost staré chování, definujte _USE_32BIT_TIME_T.To způsobí, že _futime shodovat v chování _futime32 a způsobuje _utimbuf struktury používat 32bitové časový typ, což odpovídá __utimbuf32.

_futime64, která používá __utimbuf64 struktury, můžete číst a měnit data souboru až 23: 59: 59, do 31. prosince 3000 UTC; že volání _futime32 se nezdaří, pokud je datum souboru je pozdější než 19: 14: 07 18 01.01.08, UTC.Půlnoc, 1. ledna 1970 je dolní mez rozsahu data pro tyto funkce.

Požadavky

Function	Požadované záhlaví	Volitelné záhlaví
_futime	<sys/utime.h>	<errno.h>
_futime32	<sys/utime.h>	<errno.h>
_futime64	<sys/utime.h>	<errno.h>

Další informace o kompatibilitě v tématu Compatibility v úvodu.

Příklad

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

Vstup: crt_futime.c_input

Arbitrary file contents.

Vzorový výstup

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

Ekvivalent v rozhraní .NET Framework

Viz také

Referenční dokumentace

Správa času

Sdílet prostřednictvím