_chsize_s
Cambia la dimensione di un file. Si tratta di una versione di _chsize con miglioramenti di sicurezza come descritto in Funzionalità di sicurezza in CRT.
errno_t _chsize_s(
int fd,
__int64 size
);
Parametri
fd
Il descrittore del file che fa riferimento a un file aperto.size
Nuova lunghezza del file in byte.
Valore restituito
_chsize_s restituisce il valore 0 se le dimensioni del file vengono correttamente modificate. Un valore diverso da zero indica un errore: il valore restituito è EACCES se il file specificato è bloccato all'accesso, EBADF se il file specificato è di sola lettura o il descrittore non è valido, ENOSPC se non c'è più spazio nel dispositivo, o EINVAL se la dimensione è minore di zero. errno è impostato sullo stesso valore.
Per ulteriori informazioni su questi e altri codici restituiti, vedere _doserrno, errno, _sys_errlist, e _sys_nerr.
Note
La funzione _chsize_s estende o tronca il file associato con fd alla lunghezza specificata da size. Il file deve essere aperto in una modalità che consente di scrivere. I caratteri null ('\0') vengono aggiunti se il file viene esteso. Se il file viene troncato, tutti i dati dalla fine del file ridotto alla lunghezza originale del file verranno persi.
_chsize_s accetta un intero a 64 bit come la dimensione del file e quindi può gestire dimensioni del file maggiori di 4 GB. _chsize è limitato alle dimensioni dei file a 32 bit.
Questa funzione convalida i parametri. Se fd non è un descrittore di file valido o la dimensione è minore di zero, il gestore di parametro non valido viene invocato, come descritto in Convalida dei parametri.
Requisiti
Routine |
Intestazione obbligatoria |
Intestazione facoltativa |
|---|---|---|
_chsize_s |
<io.h> |
<errno.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.