_chsize_s
Dosyanın boyutunu değiştirir. Bu işlev, CRT'deki Güvenlik özellikleri bölümünde açıklandığı gibi güvenlik geliştirmeleri içeren bir sürümüdür_chsize
.
Sözdizimi
errno_t _chsize_s(
int fd,
__int64 size
);
Parametreler
fd
Açık bir dosyaya başvuran dosya tanımlayıcısı.
size
Dosyanın bayt cinsinden yeni uzunluğu.
Dönüş değeri
_chsize_s
, dosya boyutu başarıyla değiştirilirse 0 değerini döndürür. Sıfır olmayan dönüş değeri bir hatayı gösterir: Döndürülen değer EACCES
, belirtilen dosya erişime karşı kilitlenmişse, EBADF
belirtilen dosya salt okunursa veya tanımlayıcı geçersizse, ENOSPC
cihazda boş alan kalmadıysa veya EINVAL
boyut sıfırdan küçükse olur. errno
aynı değere ayarlanır.
Bunlar ve diğer iade kodları hakkında daha fazla bilgi için bkz. errno
, _doserrno
, _sys_errlist
ve _sys_nerr
.
Açıklamalar
işlevi ile _chsize_s
ilişkilendirilmiş dosyayı tarafından size
belirtilen uzunlukla fd
genişletir veya kısaltır. Dosyanın yazmaya izin veren bir modda açık olması gerekir. Dosya genişletilmişse null karakterler ('\0') eklenir. Dosya kesilirse, kısaltılmış dosyanın sonundan dosyanın özgün uzunluğuna kadar olan tüm veriler kaybolur.
_chsize_s
dosya boyutu olarak 64 bitlik bir tamsayı alır ve bu nedenle 4 GB'tan büyük dosya boyutlarını işleyebilir. _chsize
32 bit dosya boyutlarıyla sınırlıdır.
Bu işlev parametrelerini doğrular. Geçerli bir dosya tanımlayıcısı değilse veya boyut sıfırdan küçüksefd
, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.
Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.
Gereksinimler
Yordam | Gerekli başlık | İsteğe bağlı üst bilgi |
---|---|---|
_chsize_s |
<io.h> | <errno.h> |
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.