_chsize_s
Změní velikost souboru.Toto je verze _chsize s vylepšení zabezpečení popsaným v Funkce zabezpečení v CRT.
errno_t _chsize_s(
int fd,
__int64 size
);
Parametry
fd
Popisovač souboru ve vztahu k otevření souboru.size
Nová délka souboru v bajtech.
Vrácená hodnota
_chsize_s Vrátí hodnotu 0, pokud velikost souboru úspěšně změněno.Vrácená nenulová hodnota označuje chybu: Vrácená hodnota je EACCES Pokud zadaný soubor je uzamčen proti přístupu, EBADF -li zadaný soubor je jen pro čtení nebo je neplatný, ENOSPC Pokud již není místo na zařízení, nebo EINVAL Pokud velikost je menší než nula.errno je nastavena na stejnou hodnotu.
Další informace o těchto a jiných návratové kódy, viz _doserrno, kód chyby, _sys_errlist a _sys_nerr.
Poznámky
_chsize_s Funkce rozšiřuje nebo zkrátí soubor přidružený k fd na délku uvedenou size.Soubor musí být otevřen v režimu, který umožňuje psaní.Pokud je soubor rozšířen, jsou připojeny znaky Null (\0).Pokud je soubor zkrácen, všechna data z konce zkrácený soubor na původní délku souboru ztracen.
_chsize_s trvá 64bitové celé číslo, jako velikost souboru a proto může zpracovávat velikost souboru je větší než 4 GB._chsize je omezena velikost souboru 32-bit.
Tato funkce ověřuje jeho parametry.Pokud fd není platný soubor deskriptoru nebo velikost je menší než nula, je vyvolána neplatný parametr popisovače, jak je popsáno v Ověření parametrů.
Požadavky
Rutina |
Požadované záhlaví |
Volitelné záhlaví |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Další informace o kompatibilitě v tématu Compatibility v úvodu.