共用方式為

_futime，_futime32 _futime64

  • 發行項

在開啟的檔案上設定的修改時間。

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

參數

  • fd
    若要開啟的檔案的檔案描述項。

  • filetime
    包含新的修改日期的結構指標。

傳回值

如果成功的話，則傳回 0。 如果發生錯誤，無效的參數處理常式會叫用，如所述參數驗證。 如果執行，則允許繼續執行，則函數會傳回 – 1 及errno設定為 [ EBADF，表示無效的檔案描述項，或EINVAL，指出不正確的參數。

備註

_futime常式設定的相關聯的開啟檔案的修改日期 」 和 「 存取時間fd*.*_futime與 _utime，不同之處在於其引數是開啟的檔案的檔案描述項，而不是檔案或檔案的路徑名稱。  _utimbuf結構包含新的修改日期以及存取時間的欄位。 這兩個欄位必須包含有效的值。 _utimbuf32與_utimbuf64等於_utimbuf除了使用 32 位元與 64 位元的時間型別中，分別。 _futime與_utimbuf ，請使用 64 位元時間類型和_futime行為中有相同的_futime64。 如果您需要強制舊的行為，請定義_USE_32BIT_TIME_T。 如此一來，這會導致_futime ，使其相同的行為在_futime32 ，並且會導致_utimbuf結構，以使用 32 位元時間的型別，使其成為相當於__utimbuf32。

_futime64使用__utimbuf64結構、 讀取和修改檔案日期 23: 59: 59 之間，3000 年 12 月 31 UTC。 而呼叫_futime32檔案的日期是否晚於 19: 14: 07 以後 2038 年 1 月 18 日，UTC，就會失敗。 午夜 1970 年 1 月 1 日，會為這些函式之日期範圍的下限。

需求

Function

所需的標頭

選擇性標頭

_futime

<sys/utime.h>

<errno.h>

_futime32

<sys/utime.h>

<errno.h>

_futime64

<sys/utime.h>

<errno.h>

如需相容性資訊，請參閱相容性在簡介中。

範例

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

輸入: crt_futime.c_input

Arbitrary file contents.

8592kht8.collapse_all(zh-tw,VS.110).gif範例輸出

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 對等用法

請參閱

參考

時間管理