_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ść.