Udostępnij za pośrednictwem


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

Odpowiednik w programie .NET Framework

Zobacz też

Informacje

Obsługa plików

_chsize

_close

_creat, _wcreat

_open, _wopen