_chsize_s

Zmienia rozmiar pliku. Ta funkcja jest wersją z ulepszeniami zabezpieczeń _chsize zgodnie z opisem w temacie Funkcje zabezpieczeń w narzędziu CRT.

Składnia

errno_t _chsize_s(
   int fd,
   __int64 size
);

Parametry

fd
Deskryptor plików odwołujący się do otwartego pliku.

size
Nowa długość pliku w bajtach.

Wartość zwracana

_chsize_s Zwraca wartość 0, jeśli rozmiar pliku został pomyślnie zmieniony. Wartość niezerowa wskazuje błąd: wartość zwracana jest EACCES wtedy, gdy określony plik jest zablokowany przed dostępem, EBADF jeśli określony plik jest tylko do odczytu lub deskryptor jest nieprawidłowy, ENOSPC jeśli na urządzeniu nie ma miejsca lub EINVAL jeśli rozmiar jest mniejszy niż zero. errno jest ustawiona na tę samą wartość.

Aby uzyskać więcej informacji na temat tych i innych kodów powrotnych, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Funkcja _chsize_s rozszerza lub obcina plik skojarzony z długością fd określoną przez size. Plik musi być otwarty w trybie, który zezwala na zapisywanie. Znaki null ('\0') są dołączane, jeśli plik został rozszerzony. Jeśli plik zostanie obcięty, wszystkie dane z końca skróconego pliku do oryginalnej długości pliku zostaną utracone.

_chsize_s przyjmuje 64-bitową liczbę całkowitą jako rozmiar pliku i dlatego może obsługiwać rozmiary plików większe niż 4 GB. _chsize jest ograniczony do 32-bitowych rozmiarów plików.

Ta funkcja weryfikuje jego parametry. Jeśli fd nie jest prawidłowym deskryptorem pliku lub rozmiar jest mniejszy niż zero, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Procedura	Wymagany nagłówek	Opcjonalny nagłówek
_chsize_s	<io.h>	<errno.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

Obsługa plików
_chsize
_close
_creat, _wcreat
_open, _wopen