`_chsize_s`

Artikel
10/12/2023

Mengubah ukuran file. Fungsi ini adalah versi _chsize dengan peningkatan keamanan seperti yang dijelaskan dalam Fitur keamanan di CRT.

Sintaks

errno_t _chsize_s(
   int fd,
   __int64 size
);

Parameter

fd
Pendeskripsi file yang mengacu pada file yang terbuka.

size
Panjang baru file dalam byte.

Nilai hasil

_chsize_s mengembalikan nilai 0 jika ukuran file berhasil diubah. Nilai pengembalian bukan nol menunjukkan kesalahan: nilai pengembalian adalah EACCES jika file yang ditentukan dikunci terhadap akses, EBADF jika file yang ditentukan bersifat baca-saja atau deskriptor tidak valid, ENOSPC jika tidak ada spasi yang tersisa di perangkat, atau EINVAL jika ukuran kurang dari nol. errno diatur ke nilai yang sama.

Untuk informasi selengkapnya tentang kode pengembalian ini dan lainnya, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Fungsi memperluas _chsize_s atau memotong file yang terkait dengan fd panjang yang ditentukan oleh size. File harus terbuka dalam mode yang mengizinkan penulisan. Karakter null ('\0') ditambahkan jika file diperluas. Jika file dipotong, semua data dari akhir file yang dipersingkat ke panjang asli file akan hilang.

_chsize_s mengambil bilangan bulat 64-bit sebagai ukuran file, dan oleh karena itu dapat menangani ukuran file yang lebih besar dari 4 GB. _chsize dibatasi hingga ukuran file 32-bit.

Fungsi ini memvalidasi parameternya. Jika fd bukan deskriptor atau ukuran file yang valid kurang dari nol, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin	Header yang diperlukan	Header opsional
`_chsize_s`	<io.h>	<errno.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.