_chsize_s
Zmienia rozmiar pliku.Jest to wersja z _chsize z rozszerzeń zabezpieczeń opisane w Funkcje zabezpieczeń w CRT.
errno_t _chsize_s(
int fd,
__int64 size
);
Parametry
fd
Plik deskryptora odnoszące się do otwartego pliku.size
Długość nowego pliku w bajtach.
Wartość zwracana
_chsize_s Zwraca wartość 0, jeśli rozmiar pliku jest pomyślnie zmienione.Zwracana wartość różną od zera wskazuje na błąd: wartość zwracana jest EACCES Jeśli określony plik jest zablokowany przed dostępem, EBADF Jeśli określony plik jest tylko do odczytu lub deskryptora jest nieprawidłowy, ENOSPC Jeżeli nie miejsca na urządzeniu, lub EINVAL Jeśli rozmiar jest mniejszy od zera.errno jest ustawiona na tę samą wartość.
Aby uzyskać więcej informacji na temat tych i innych kodów powrotu, zobacz _doserrno, errno, _sys_errlist i _sys_nerr.
Uwagi
_chsize_s Funkcja rozszerza lub obcina plik skojarzony z fd do długości określonej przez size.Plik musi być otwarta w trybie, który zezwala na piśmie.Znakami null (\0) są dołączane, jeśli plik jest rozszerzany.Jeśli plik jest obcięty, wszystkie dane z końca pliku skrócone do długości oryginalnego pliku zostaną utracone.
_chsize_s Trwa 64-bitowe liczby całkowite, jak rozmiar pliku i dlatego może obsłużyć rozmiary plików większych niż 4 GB._chsize jest ograniczona do 32-bitowe pliki o rozmiarach.
Funkcja ta sprawdza poprawność jego parametry.Jeśli fd nie jest prawidłowy plik deskryptora lub rozmiar jest mniejszy od zera, wywoływana jest funkcja obsługi nieprawidłowy parametr, jak opisano w Sprawdzanie poprawności parametru.
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
Opcjonalne nagłówka |
---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Informacji dotyczących zgodności, zobacz zgodności we wprowadzeniu.