_chsize_s

Modifica la dimensione di un file. Questa funzione è una versione di con miglioramenti della _chsize sicurezza, come descritto in Funzionalità di sicurezza in CRT.

Sintassi

errno_t _chsize_s(
   int fd,
   __int64 size
);

Parametri

fd
Descrittore del file che fa riferimento a un file aperto.

size
Nuova lunghezza, in byte, del file.

Valore restituito

_chsize_s restituisce il valore 0 se la dimensione del file viene modificata. Un valore restituito diverso da zero indica un errore: il valore restituito è EACCES se il file specificato è bloccato per impedire l'accesso, EBADF se il file specificato è di sola lettura o il descrittore non è valido, ENOSPC se non è rimasto spazio nel dispositivo o EINVAL se la dimensione è minore di zero. errno è impostata sullo stesso valore.

Per altre informazioni su questi e altri codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

La funzione _chsize_s estende o tronca il file associato a fd in base alla lunghezza specificata da size. Il file deve essere aperto in una modalità che consente la scrittura. Se il file viene esteso, vengono aggiunti caratteri null ("\0"). Se il file viene troncato, si perderanno tutti i dati a partire dalla fine del file abbreviato fino alla fine del file originale.

_chsize_s accetta un valore Integer a 64 bit come dimensione del file ed è quindi in grado di gestire file di dimensioni superiori a 4 GB. _chsize è limitata alle dimensioni dei file a 32 bit.

Questa funzione convalida i relativi parametri. Se fd non è un descrittore di file valido o dimensioni è minore di zero, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo	Intestazione obbligatoria	Intestazione facoltativa
_chsize_s	<io.h>	<errno.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

Gestione dei file
_chsize
_close
_creat, _wcreat
_open, _wopen