Aracılığıyla paylaş


_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_errlistve _sys_nerr.

Açıklamalar

işlevi ile _chsize_s ilişkilendirilmiş dosyayı tarafından sizebelirtilen 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.

Ayrıca bkz.

Dosya işleme
_chsize
_close
_creat, _wcreat
_open, _wopen