`_chsize_s`

Článek
10/12/2023

Změní velikost souboru. Tato funkce je verze _chsize s vylepšeními zabezpečení, jak je popsáno v funkcích zabezpečení v CRT.

Syntaxe

errno_t _chsize_s(
   int fd,
   __int64 size
);

Parametry

fd
Popisovač souboru odkazující na otevřený soubor.

size
Nová délka souboru v bajtech

Vrácená hodnota

_chsize_s vrátí hodnotu 0, pokud je velikost souboru úspěšně změněna. Nenulová návratová hodnota značí chybu: návratová hodnota je EACCES , pokud je zadaný soubor uzamčen proti přístupu, EBADF pokud je zadaný soubor jen pro čtení nebo popisovač je neplatný, ENOSPC pokud není v zařízení ponecháno žádné místo nebo EINVAL pokud je velikost menší než nula. errno je nastavená na stejnou hodnotu.

Další informace o těchto a dalších návratových kódech naleznete v tématu , , , a_sys_nerr . _sys_errlist_doserrnoerrno

Poznámky

Funkce _chsize_s rozšiřuje nebo zkracuje soubor přidružený fd k délce určené .size Soubor musí být otevřený v režimu, který umožňuje zápis. Pokud je soubor rozšířený, připojují se znaky null (\0). Pokud je soubor zkrácený, všechna data z konce zkráceného souboru na původní délku souboru se ztratí.

_chsize_s přebírá 64bitové celé číslo jako velikost souboru, a proto dokáže zpracovat velikosti souborů větší než 4 GB. _chsize je omezena na 32bitové velikosti souborů.

Tato funkce ověří své parametry. Pokud fd není platný popisovač souboru nebo je menší než nula, vyvolá se neplatná obslužná rutina parametru, jak je popsáno v ověření parametru.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Rutina	Požadovaný hlavičkový soubor	Volitelné záhlaví
`_chsize_s`	<io.h>	<errno.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Viz také

Zpracování souborů
_chsize
_close
_creat, _wcreat
_open, _wopen

Sdílet prostřednictvím