_futime, _futime32, _futime64
Açık bir dosya üzerinde değişiklik zamanı ayarlar.
int _futime(
int fd,
struct _utimbuf *filetime
);
int _futime32(
int fd,
struct __utimbuf32 *filetime
);
int _futime64(
int fd,
struct __utimbuf64 *filetime
);
Parametreler
fd
Açık dosyaya dosya tanımlayıcısı.filetime
Yeni değiştirilme tarihi içeren yapısı için işaretçi.
Dönüş Değeri
Başarılı olursa 0 döndürür.Bir hata oluşursa, geçersiz parametre işleyicisi, açıklandığı şekilde çağrılır Parametre Doğrulama.Yürütülmesine devam etmek için izin verilmişse işlev –1 değerini döndürür ve errno ayarlamak EBADF, geçersiz dosya tanımlayıcısı gösteren veya EINVAL, geçersiz bir parametre gösteren.
Notlar
_futime Yordamı ile ilişkili açık dosya ayarlar değiştirilme tarihi ve erişim süresini fd*.*_futime olan aynı _utime, bağımsız bir dosya veya bir dosyaya bir yol adı yerine, açık bir dosyayı, dosya tanımlayıcısı olan olmasıdır. _utimbuf Yapısı, yeni değiştirilme tarihi ve erişim süresi için alanlar içeriyor.Her iki alan geçerli değerler içermelidir._utimbuf32ve _utimbuf64 aynıdır _utimbuf 32-bit ve 64-bit zaman türleri kullanım için sırasıyla hariç._futimeve _utimbuf 64-bit saat türü kullanın ve _futime için davranış aynıdır _futime64.Eski davranışı zorlamak gerekirse tanımlamak _USE_32BIT_TIME_T.Bu neden bunu _futime davranış için aynı olması için _futime32 neden olur ve _utimbuf eşdeğer hale getirme, 32-bit süre türünü kullanmak için yapı __utimbuf32.
_futime64, kullanan __utimbuf64 yapısı, okuyabilir ve 23: 59: 59, 31 Aralık 3000 utc; üzerinden dosya tarihleri değiştirme Oysa bir çağrı _futime32 dosya tarihinde 19: 14: 07'den 18 Ocak 2038 utc daha sonra başarısız olur.Gece yarısı, 1 Ocak 1970, bu işlevler için tarih aralığı alt sınırdır.
Gereksinimler
İşlev |
Gerekli başlık |
İsteğe bağlı bir üstbilgi |
---|---|---|
_futime |
<sys/utime.h> |
<errno.h> |
_futime32 |
<sys/utime.h> |
<errno.h> |
_futime64 |
<sys/utime.h> |
<errno.h> |
Daha fazla uyumluluk bilgileri için bkz: Uyumluluk giriş.
Örnek
// 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" );
}
Giriş: crt_futime.c_input
Arbitrary file contents.
Örnek Çıktı
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